Função D3DKMTSharedPrimaryLockNotification (d3dkmthk.h)
A função D3DKMTSharedPrimaryLockNotification notifica o sistema operacional sobre um bloqueio próximo para uma superfície primária compartilhada.
Sintaxe
NTSTATUS D3DKMTSharedPrimaryLockNotification(
[in] const D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION *unnamedParam1
);
Parâmetros
[in] unnamedParam1
Um ponteiro para uma estrutura de D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION que descreve a superfície primária compartilhada que um aplicativo bloqueará.
Valor de retorno
D3DKMTSharedPrimaryLockNotification retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| STATUS_SUCCESS | A notificação sobre um bloqueio próximo para uma superfície primária compartilhada foi executada com êxito. |
| STATUS_NO_MEMORY | D3DKMTSharedPrimaryLockNotification não pôde ser concluída 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 de NTSTATUS definidos em Ntstatus.h.
Observações
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 na origem do vídeo que o AdapterLuid e VidPnSourceId membros da estrutura D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION especificar. 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 LockRect membro do D3DKMT_SHAREDPRIMARYLOCKNOTIFICATION.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Universal |
| cabeçalho | d3dkmthk.h (inclua D3dkmthk.h) |
| biblioteca | Gdi32.lib |
| de DLL | Gdi32.dll |