DXGKCB_MULTIPLANEOVERLAYDISABLED funzione di callback (d3dkmddi.h)

  • Articolo

Un driver miniport in modalità kernel chiama DXGKCB_MULTIPLANEOVERLAYDISABLED per indicare che la configurazione MPO (Multiplane Overlay) corrente non è più supportata nel VidPnSourceId specificato.

Sintassi

DXGKCB_MULTIPLANEOVERLAYDISABLED DxgkcbMultiplaneoverlaydisabled;

void DxgkcbMultiplaneoverlaydisabled(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT VidPnSourceId
)
{...}

Parametri

[in] hAdapter

Handle per l'adattatore in cui la configurazione hardware MPO corrente non è più supportata.

[in] VidPnSourceId

VidPnSourceId in cui la configurazione hardware MPO corrente non è più supportata.

Valore restituito

nessuno

Osservazioni

DXGKCB_MULTIPLANEOVERLAYDISABLED notifica a Desktop Windows Manager (DWM) che la configurazione MPO corrente non è più supportata, consentendo al DWM di eseguire il fallback alla composizione.

Questa richiesta viene elaborata in modo asincrono e può essere ritardata da diversi fotogrammi. È consigliabile chiamare questa funzione solo in casi eccezionali, ad esempio gli scenari seguenti:

  • Una modifica di visualizzazione o un evento plug-hot in un output non consente più di continuare a supportare una configurazione MPO di cui viene eseguito il commit in un monitoraggio diverso. In questo caso, il driver può disabilitare i piani di sovrimpressione sul monitor. L'utente visualizzerà un artefatto visibile, ma deve essere corretto alla fine da DWM.

  • L'MPO deve essere disabilitato a causa di problemi di calore. In questo caso, il driver non deve disabilitare immediatamente MPO, ma può attendere fino a quando DWM riceve la notifica e richiede il supporto MPO (che il KMD deve indicare non è supportato a causa del problema termico). A quel punto, DWM disabiliterà MPO e inizierà a comporre.

Per i casi tipici, i driver devono invece impedire configurazioni di sovrapposizione multipla incompatibili rispondendo correttamente a DxgkDdiCheckMultiplaneOverlaySupport3.

DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, chiamare DxgkCbMultiPlaneOverlayDisabled tramite il DXGKRNL_INTERFACE.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 versione 1607 (WDDM 2.1)
Piattaforma di destinazione Windows
Intestazione d3dkmddi.h
IRQL <= PASSIVE_LEVEL

Vedi anche

DxgkDdiCheckMultiplaneOverlaySupport3

DXGKRNL_INTERFACE