DXGKDDI_SETPOINTERSHAPE funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

La funzione DxgkDdiSetPointerShape imposta l'aspetto e la posizione del puntatore del mouse.

Sintassi

DXGKDDI_SETPOINTERSHAPE DxgkddiSetpointershape;

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

Parametri

[in] hAdapter

Handle di un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport di visualizzazione precedentemente fornito questo handle al sottosistema kernel della grafica Microsoft DirectX nel MiniportDeviceContext parametro di output della funzione DxgkDdiAddDevice.

[in] pSetPointerShape

Puntatore a una struttura DXGKARG_SETPOINTERSHAPE che descrive l'aspetto e la posizione del puntatore del mouse.

Valore restituito

DxgkDdiSetPointerShape restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Il puntatore del mouse viene disegnato correttamente.
STATUS_NO_MEMORY	DxgkDdiSetPointerShape non è riuscito ad allocare memoria necessaria per il completamento.

Osservazioni

Il sottosistema kernel della grafica DirectX chiama la funzione dxgkDdiSetPointerShape del driver miniport di visualizzazione per impostare le informazioni sul puntatore del mouse. La funzione DxgkDdiSetPointerShape viene chiamata indipendentemente da tutte le altre funzioni del driver miniport di visualizzazione. Pertanto, un DxgkDdiSetPointerShape thread può essere eseguito simultaneamente con un altro thread del driver miniport di visualizzazione. Tuttavia, il sistema garantisce che DxgkDdiSetPointerShape e DxgkDdiSetPointerPosition thread non possano essere eseguiti simultaneamente.

Se si esegue un DxgkDdiSetPointerShape thread simultaneamente con un altro thread di driver miniport di visualizzazione, il driver miniport di visualizzazione dovrebbe essere in grado di programmare l'hardware del puntatore del mouse indipendentemente da altre attività, ad esempio le operazioni che inviano un buffer di comando tramite l'accesso diretto alla memoria (DMA) all'hardware grafico, operazioni che programmano l'hardware grafico usando L/O mappato alla memoria (MMIO), E così via.

dxgkDdiSetPointerShape non viene chiamato se la topologia di rete (VidPN) presente nel video associata al VidPnSourceId membro della struttura DXGKARG_SETPOINTERSHAPE a cui punta il parametro pSetPointerShape è disabilitato.

dxgkDdiSetPointerShape deve essere reso pageable.