DXGKDDI_SETPOINTERPOSITION funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

La funzione DxgkDdiSetPointerPosition imposta la posizione e lo stato di visibilità del puntatore del mouse.

Sintassi

DXGKDDI_SETPOINTERPOSITION DxgkddiSetpointerposition;

NTSTATUS DxgkddiSetpointerposition(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETPOINTERPOSITION pSetPointerPosition
)
{...}

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] pSetPointerPosition

Puntatore a una struttura DXGKARG_SETPOINTERPOSITION che descrive dove e come visualizzare il puntatore del mouse.

Valore restituito

DxgkDdiSetPointerPosition restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Commenti

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

Se si esegue un thread DxgkDdiSetPointerPosition 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 tramite I/O mappato alla memoria (MMIO), E così via.

DxgkDdiSetPointerPosition può essere chiamato anche se la topologia di rete (VidPN) presente nel video associata al membro VidPnSourceId della struttura DXGKARG_SETPOINTERPOSITION a cui punta il parametro pSetPointerPosition è disabilitata. In questo caso, il driver deve restituire STATUS_SUCCESS, ma non deve apportare modifiche allo stato del driver o dell'hardware.

DxgkDdiSetPointerPosition deve essere reso pageable.