DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 funzione di callback (d3dkmddi.h)

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 viene chiamato per modificare la configurazione della sovrimpressione visualizzata.

Sintassi

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3;

NTSTATUS DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3(
  IN_CONST_HANDLE hAdapter,
  IN_OUT_PDXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 pSetVidPnSourceAddressWithMultiPlaneOverlay
)
{...}

Parametri

hAdapter

Identifica l'adattatore contenente l'hardware di sovrimpressione.

pSetVidPnSourceAddressWithMultiPlaneOverlay

Puntatore a una struttura DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 che descrive le superfici e le opzioni di visualizzazione da presentare.

Valore restituito

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 restituisce i valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La routine è stata completata correttamente.
STATUS_INVALID_PARAMETER	Nel [modello di coda flip hardware]/windows-hardware/drivers/display/hardware-flip-queue), il driver non è riuscito a elaborare una richiesta flip.
STATUS_RETRY	Restituito per motivi come il driver non è riuscito a accodare una richiesta all'hardware a causa di capovolgimenti in sospeso o il driver deve essere chiamato al PASSIVE_LEVEL. Se il driver deve essere chiamato in PASSIVE_LEVEL deve anche impostare il DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS. Flag PrePresentNeeded.

Commenti

Questa funzione viene in genere chiamata a livello di interrupt, ma se il driver deve eseguire la configurazione hardware che può essere eseguita solo a PASSIVE_LEVEL, il driver può richiedere che questa funzione venga richiamata a PASSIVE_LEVEL restituendo STATUS_RETRY e impostando il DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS. Flag PrePresentNeeded.

Anche quando viene chiamato in PASSIVE_LEVEL, il driver deve evitare di spendere una quantità significativa di tempo in 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

Vedi anche

DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3