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 |