DXGKCB_MULTIPLANEOVERLAYDISABLED funzione di callback (d3dkmddi.h)
Un driver miniport in modalità kernel chiama DXGKCB_MULTIPLANEOVERLAYDISABLED per indicare che la configurazione MPO (Multiplane Overlay) corrente non è più supportata nell'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 di collegamento frequente in un output non consente più di continuare a supportare una configurazione MPO di cui è stato eseguito il commit in un monitor 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). In quel momento, DWM disabiliterà MPO e inizierà a comporre.
Per i casi tipici, i driver devono invece impedire configurazioni di sovrapposizione multipla non compatibili rispondendo correttamente a DxgkDdiCheckMultiplaneOverlaySupport3.
DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, chiamare DxgkCbMultiPlaneOverlayDisabled tramite il DXGKRNL_INTERFACE.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10, versione 1607 (WDDM 2.1) |
| piattaforma di destinazione | Finestre |
| intestazione | d3dkmddi.h |
| IRQL | <= PASSIVE_LEVEL |