Функция D3DKMTSharedPrimaryLockNotification (d3dkmthk.h)

Функция D3DKMTSharedPrimaryLockNotification уведомляет операционную систему о предстоящей блокировке для общей первичной поверхности.

Синтаксис

NTSTATUS D3DKMTSharedPrimaryLockNotification(
  [in] const D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION *unnamedParam1
);

Параметры

[in] unnamedParam1

Указатель на структуру D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION, описывающую общую первичную поверхность, которую приложение заблокирует.

Возвращаемое значение

D3DKMTSharedPrimaryLockNotification возвращает одно из следующих значений:

Возвращаемый код Описание
STATUS_SUCCESS Уведомление о предстоящей блокировке для общей первичной поверхности успешно выполнено.
STATUS_NO_MEMORY D3DKMTSharedPrimaryLockNotification не удалось завершить из-за нехватки памяти.
STATUS_INVALID_PARAMETER Параметры были проверены и определены как неверные.

Эта функция также может возвращать другие NTSTATUS значения, определенные в Ntstatus.h.

Замечания

OpenGL ICD вызывает функцию D3DKMTSharedPrimaryLockNotification, чтобы сообщить операционной системе, что приложение собиралось заблокировать общую первичную поверхность GDI, которая существует на графическом адаптере и видео- источнике, который AdapterLuid и VidPnSourceId элементах структуры D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION. OpenGL ICD должен вызывать D3DKMTSharedPrimaryLockNotification, прежде чем вызывать функцию D3DKMTLock для общей основной поверхности GDI, чтобы убедиться, что операционная система отключает все спрайты, пересекающиеся с областью блокировки, которую lockRect член D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista
целевая платформа Всеобщий
заголовка d3dkmthk.h (include D3dkmthk.h)
библиотеки Gdi32.lib
DLL Gdi32.dll

См. также

D3DKMTLock

D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION