DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

Chiamato dopo che è stata applicata una nuova configurazione di sovrapposizione multiplano, consentendo al driver di ottimizzare lo stato hardware. Facoltativo per i driver WDDM (Windows Display Driver Model) 2.0 o versioni successive che supportano sovrapposizioni multiplano.

Sintassi

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT DxgkddiPostmultiplaneoverlaypresent;

NTSTATUS DxgkddiPostmultiplaneoverlaypresent(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_POSTMULTIPLANEOVERLAYPRESENT pPostPresent
)
{...}

Parametri

hAdapter

Identifica l'adattatore contenente l'hardware di sovrimpressione.

pPostPresent

Puntatore a una struttura DXGKARG_POSTMULTIPLANEOVERLAYPRESENT che descrive la nuova configurazione di sovrimpressione di cui è stato eseguito di recente il commit.

Valore restituito

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT restituisce i valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Se la routine è stata completata correttamente. Il driver deve restituire sempre un codice di operazione riuscita. Gli errori genereranno un controllo bug.

Osservazioni

Questa funzione viene chiamata dal livello PASSIVE.

Questa funzione viene chiamata solo quando il driver imposta PostPresentNeeded di DXGKCB_NOTIFY_MPO_VSYNC_FLAGS membro della struttura DXGKARGCB_NOTIFY_INTERRUPT_DATA nel callback VSYNC.

Il driver può usare questa funzione per ridurre i livelli di tensione, gli orologi, le profondità FIFO o qualsiasi altra ottimizzazione in grado di risparmiare energia.

Il driver non deve dedicare molto tempo in questa chiamata perché la chiamata blocca il thread principale dell'utilità di pianificazione GPU e il ritardo potrebbero causare problemi. Le azioni a elevato utilizzo di tempo devono essere accodate come elementi di lavoro separati dal driver e gestite in background. In questo scenario, eventuali conflitti tra l'elemento in coda e le modifiche hardware richieste dalle future chiamate pre/post devono essere gestite dal driver.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	d3dkmddi.h

Condividi tramite