Функция 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.

Комментарии

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

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Целевая платформа Универсальное
Верхняя часть d3dkmthk.h (включая D3dkmthk.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

См. также раздел

D3DKMTLock

D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION