DXGKCB_MULTIPLANEOVERLAYDISABLED Rückruffunktion (d3dkmddi.h)
Ein Kernelmodus-Miniporttreiber ruft DXGKCB_MULTIPLANEOVERLAYDISABLED auf, um anzugeben, dass die aktuelle MPO-Konfiguration (Multiplane Overlay) für die angegebene VidPnSourceIdnicht mehr unterstützt wird.
Syntax
DXGKCB_MULTIPLANEOVERLAYDISABLED DxgkcbMultiplaneoverlaydisabled;
void DxgkcbMultiplaneoverlaydisabled(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT VidPnSourceId
)
{...}
Parameter
[in] hAdapter
Behandeln Sie den Adapter, auf dem die aktuelle MPO-Hardwarekonfiguration nicht mehr unterstützt wird.
[in] VidPnSourceId
Die VidPnSourceId, für die die aktuelle MPO-Hardwarekonfiguration nicht mehr unterstützt wird.
Rückgabewert
Nichts
Bemerkungen
DXGKCB_MULTIPLANEOVERLAYDISABLED benachrichtigt den Desktop Windows Manager (DWM), dass die aktuelle MPO-Konfiguration nicht mehr unterstützt wird, sodass dwM auf die Komposition zurückgreifen kann.
Diese Anforderung wird asynchron verarbeitet und kann von mehreren Frames verzögert werden. Es wird empfohlen, diese Funktion nur in Ausnahmefällen wie den folgenden Szenarien aufzurufen:
Ein Anzeigeänderungs- oder Hot-Plug-Ereignis in einer Ausgabe ermöglicht es nicht mehr, eine MPO-Konfiguration, die für einen anderen Monitor zugesichert ist, weiterhin zu unterstützen. In diesem Fall kann der Fahrer die Überlagerungsebenen auf dem Monitor deaktivieren. Der Benutzer sieht ein sichtbares Artefakt, sollte aber schließlich von der DWM korrigiert werden.
MPO sollte aufgrund von thermischen Problemen deaktiviert werden. In diesem Fall muss der Treiber MPO nicht sofort deaktivieren, kann aber warten, bis der DWM die Benachrichtigung empfängt und MPO-Unterstützung erfordert (die der KMD aufgrund des thermischen Problems nicht unterstützt wird). Zu diesem Zeitpunkt deaktiviert der DWM MPO und beginnt mit dem Verfassen.
In typischen Fällen sollten Treiber stattdessen inkompatible Multiplane-Overlaykonfigurationen verhindern, indem sie ordnungsgemäß auf DxgkDdiCheckMultiplaneOverlaySupport3-reagieren.
DXGKCB_XXX Funktionen werden von Dxgkrnlimplementiert. Rufen Sie DxgkCbMultiPlaneOverlayDisabled über die DXGKRNL_INTERFACEauf, um diese Rückruffunktion zu verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1607 (WDDM 2.1) |
| Zielplattform- | Fenster |
| Header- | d3dkmddi.h |
| IRQL- | <= PASSIVE_LEVEL |