Compartilhar via


Função D3DKMTSharedPrimaryLockNotification (d3dkmthk.h)

A função D3DKMTSharedPrimaryLockNotification notifica o sistema operacional sobre um bloqueio futuro para uma superfície primária compartilhada.

Sintaxe

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

Parâmetros

[in] unnamedParam1

Um ponteiro para uma estrutura D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION que descreve a superfície primária compartilhada que um aplicativo bloqueará.

Retornar valor

D3DKMTSharedPrimaryLockNotification retorna um dos seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS A notificação sobre um bloqueio futuro para uma superfície primária compartilhada foi executada com êxito.
STATUS_NO_MEMORY D3DKMTSharedPrimaryLockNotification não pôde ser concluído devido à memória insuficiente.
STATUS_INVALID_PARAMETER Os parâmetros foram validados e determinados como incorretos.

Essa função também pode retornar outros valores NTSTATUS definidos em Ntstatus.h.

Comentários

O OpenGL ICD chama a função D3DKMTSharedPrimaryLockNotification para informar ao sistema operacional que um aplicativo está prestes a bloquear a superfície primária compartilhada GDI que existe no adaptador gráfico e no vídeo apresentam a origem que os membros AdapterLuid e VidPnSourceId da estrutura D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION especificam. O OpenGL ICD deve chamar D3DKMTSharedPrimaryLockNotification antes de chamar a função D3DKMTLock para a superfície primária compartilhada GDI para garantir que o sistema operacional desabilite todos os sprites que se cruzam com a região de bloqueio especificada pelo membro LockRect do D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Universal
Cabeçalho d3dkmthk.h (inclua D3dkmthk.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

D3DKMTLock

D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION