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

Artigo
05/26/2023

A função DxgkDdiSetPointerShape define a aparência e o local do ponteiro do mouse.

Sintaxe

DXGKDDI_SETPOINTERSHAPE DxgkddiSetpointershape;

NTSTATUS DxgkddiSetpointershape(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETPOINTERSHAPE pSetPointerShape
)
{...}

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 no parâmetro de saída MiniportDeviceContext da função DxgkDdiAddDevice .

[in] pSetPointerShape

Um ponteiro para uma estrutura DXGKARG_SETPOINTERSHAPE que descreve a aparência e o local do ponteiro do mouse.

Retornar valor

DxgkDdiSetPointerShape retorna um dos seguintes valores:

Código de retorno	Descrição
STATUS_SUCCESS	O ponteiro do mouse é desenhado com êxito.
STATUS_NO_MEMORY	DxgkDdiSetPointerShape não pôde alocar memória necessária para que ela fosse concluída.

Comentários

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

Se você executar um thread DxgkDdiSetPointerShape 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 de DMA (acesso direto à memória) para o hardware gráfico, operações que programam o hardware gráfico usando E/S mapeada por memória (MMIO), e assim por diante.

DxgkDdiSetPointerShape não será chamado se a topologia VidPN (rede presente em vídeo) associada ao membro VidPnSourceId da estrutura DXGKARG_SETPOINTERSHAPE à qual o parâmetro pSetPointerShape aponta estiver desabilitada.

DxgkDdiSetPointerShape deve ser tornado paginável.