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 |