DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT funzione di callback (d3dkmddi.h)

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:

Commenti

Questa funzione viene chiamata dal livello PASSIVO.

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 a questa chiamata perché la chiamata blocca il thread principale dell'utilità di pianificazione GPU e il ritardo potrebbe causare problemi. Le azioni a elevato utilizzo di tempo devono essere accodate come elementi di lavoro separati dal driver e gestiti 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.

Requisiti