DXGKDDI_SETPOINTERPOSITION função de retorno de chamada (d3dkmddi.h)

A função DxgkDdiSetPointerPosition define o local e o estado de visibilidade do ponteiro do mouse.

Sintaxe

DXGKDDI_SETPOINTERPOSITION DxgkddiSetpointerposition;

NTSTATUS DxgkddiSetpointerposition(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETPOINTERPOSITION pSetPointerPosition
)
{...}

Parâmetros

[in] hAdapter

Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporta de exibição anteriormente forneceu esse identificador para o subsistema kernel de elementos gráficos do Microsoft DirectX no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice .

[in] pSetPointerPosition

Um ponteiro para uma estrutura DXGKARG_SETPOINTERPOSITION que descreve onde e como exibir o ponteiro do mouse.

Retornar valor

DxgkDdiSetPointerPosition retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

O subsistema de kernel de elementos gráficos DirectX chama a função DxgkDdiSetPointerPosition do driver de miniporta de exibição para definir o local do ponteiro do mouse. A função DxgkDdiSetPointerPosition é chamada independentemente de todas as outras funções de driver de miniporto de exibição. Portanto, um thread DxgkDdiSetPointerPosition pode ser executado simultaneamente com outro thread de driver de miniporta de exibição. No entanto, o sistema garante que os threads DxgkDdiSetPointerPosition e DxgkDdiSetPointerShape não possam ser executados simultaneamente.

Se você executar um thread DxgkDdiSetPointerPosition simultaneamente com outro thread de driver de miniporta de exibição, o driver de miniporto de exibição deverá ser capaz de programar o hardware do ponteiro do mouse independentemente de outras atividades, como operações que enviam um buffer de comando por meio do DMA (acesso direto à memória) para o hardware gráfico, operações que programam o hardware gráfico usando MMIO (E/S mapeada em memória), e assim por diante.

DxgkDdiSetPointerPosition pode ser chamado mesmo que a topologia de VidPN (rede presente em vídeo) associada ao membro VidPnSourceId da estrutura DXGKARG_SETPOINTERPOSITION para a qual o parâmetro pSetPointerPosition aponta esteja desabilitada. Nesse caso, o driver deve retornar STATUS_SUCCESS, mas não deve fazer alterações no estado do driver ou do hardware.

DxgkDdiSetPointerPosition deve ser tornado paginável.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3dkmddi.h (inclua D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Confira também

DXGKARG_SETPOINTERPOSITION

DxgkDdiAddDevice

DxgkDdiSetPointerShape