DXGKDDI_SETPOINTERPOSITION função de retorno de chamada (d3dkmddi.h)
A função DxgkDdiSetPointerPosition define o estado de localização e 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 miniporto de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX na função MiniportDeviceContext da função DxgkDdiAddDevice.
[in] pSetPointerPosition
Um ponteiro para uma estrutura DXGKARG_SETPOINTERPOSITION que descreve onde e como exibir o ponteiro do mouse.
Valor de retorno
DxgkDdiSetPointerPosition retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um dos códigos de erro definidos em Ntstatus.h.
Observações
O subsistema de kernel de elementos gráficos DirectX chama a função DxgkDdiSetPointerPosition do driver 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 miniporto de exibição. No entanto, o sistema garante que DxgkDdiSetPointerPosition e threads de DxgkDdiSetPointerShape não possam ser executados simultaneamente.
Se você executar um DxgkDdiSetPointerPosition thread simultaneamente com outro thread de driver de miniporto 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 mapeado pela memória), e assim por diante.
DxgkDdiSetPointerPosition pode ser chamado mesmo se a topologia VidPN (rede presente em vídeo) associada ao VidPnSourceId membro da estrutura de DXGKARG_SETPOINTERPOSITION à qual o parâmetro pSetPointerPosition está desabilitado. Nesse caso, o driver deve retornar STATUS_SUCCESS mas não deve fazer alterações no estado do driver ou do hardware.
DxgkDdiSetPointerPosition deve ficar paginável.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h (inclua D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |