DXGKDDI_SETPOINTERSHAPE função de retorno de chamada (d3dkmddi.h)
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 na função 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.
Valor de retorno
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. |
Observações
O subsistema de kernel de elementos gráficos DirectX chama a função DxgkDdiSetPointerShape do driver 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 miniporto de exibição. No entanto, o sistema garante que DxgkDdiSetPointerShape e threads DxgkDdiSetPointerPosition não possam ser executados simultaneamente.
Se você executar um DxgkDdiSetPointerShape 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 de 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.
DxgkDdiSetPointerShape não será chamada se a topologia VidPN (rede presente em vídeo) associada ao VidPnSourceId membro da estrutura DXGKARG_SETPOINTERSHAPE à qual o parâmetro pSetPointerShape está desabilitado.
DxgkDdiSetPointerShape 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 |
| IRQL | PASSIVE_LEVEL |