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 di scorrimento. |
| STATUS_RETRY | Restituito per motivi come il driver non è riuscito a accodare una richiesta all'hardware a causa di capovolgimenti in sospeso o che 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 di PrePresentNeeded. |
Osservazioni
Questa funzione viene in genere chiamata a livello di interrupt, ma se il driver deve eseguire la configurazione hardware che può essere eseguita solo in PASSIVE_LEVEL, il driver può richiedere che questa funzione venga richiamata in PASSIVE_LEVEL restituendo STATUS_RETRY e impostando il DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS.flag di PrePresentNeeded.
Anche quando viene chiamato in PASSIVE_LEVEL, il driver dovrebbe 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 potrebbero causare problemi presenti. 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 |