DXGKDDI_SETPOINTERSHAPE funzione di callback (d3dkmddi.h)

Articolo
05/26/2023

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 fornito in precedenza questo handle al sottosistema kernel della grafica Microsoft DirectX nel parametro di output MiniportDeviceContext 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.

Commenti

Il sottosistema kernel grafico 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 dello schermo. Di conseguenza, un thread DxgkDdiSetPointerShape può essere eseguito contemporaneamente con un altro thread di driver miniport di visualizzazione. Tuttavia, il sistema garantisce che i thread DxgkDdiSetPointerShape e DxgkDdiSetPointerPosition non possano essere eseguiti simultaneamente.

Se si esegue un thread DxgkDdiSetPointerShape contemporaneamente con un altro thread di driver miniport di visualizzazione, il driver miniport di visualizzazione deve 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 membro VidPnSourceId della struttura DXGKARG_SETPOINTERSHAPE a cui punta il parametro pSetPointerShape è disabilitata.

DxgkDdiSetPointerShape deve essere reso pageable.