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:

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

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

Requisito Valore
Piattaforma di destinazione Windows
Intestazione d3dkmddi.h