DXGKCB_MULTIPLANEOVERLAYDISABLED Rückruffunktion (d3dkmddi.h)
Ein Display-Miniporttreiber im Kernelmodus ruft DXGKCB_MULTIPLANEOVERLAYDISABLED auf, um anzugeben, dass die aktuelle MPO-Konfiguration (Multiplane Overlay) für die angegebene VidPnSourceId nicht mehr unterstützt wird.
Syntax
DXGKCB_MULTIPLANEOVERLAYDISABLED DxgkcbMultiplaneoverlaydisabled;
void DxgkcbMultiplaneoverlaydisabled(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT VidPnSourceId
)
{...}
Parameter
[in] hAdapter
Handle mit dem 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
Keine
Bemerkungen
DXGKCB_MULTIPLANEOVERLAYDISABLED benachrichtigt den Desktop-Windows-Manager (DWM), dass die aktuelle MPO-Konfiguration nicht mehr unterstützt wird, sodass der DWM auf die Komposition zurückgreifen kann.
Diese Anforderung wird asynchron verarbeitet und kann um mehrere Frames verzögert werden. Es wird empfohlen, diese Funktion nur in Ausnahmefällen wie den folgenden Szenarien aufzurufen:
Eine Anzeigeänderung oder ein Hot-Plug-Ereignis auf einer Ausgabe ermöglicht es nicht mehr, eine MPO-Konfiguration, die an einen anderen Monitor committet wird, weiterhin zu unterstützen. In diesem Fall kann der Treiber die Überlagerungsebenen auf dem Monitor deaktivieren. Dem Benutzer wird ein sichtbares Artefakt angezeigt, es sollte jedoch schließlich vom 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 erhält und MPO-Unterstützung benötigt (was der KMD angeben sollte, dass aufgrund des thermischen Problems nicht unterstützt wird). Zu diesem Zeitpunkt deaktiviert der DWM MPO und beginnt mit dem Komponieren.
In typischen Fällen sollten Treiber stattdessen inkompatible Überlagerungskonfigurationen mit mehreren Ebenen verhindern, indem sie ordnungsgemäß auf DxgkDdiCheckMultiplaneOverlaySupport3 reagieren.
DXGKCB_XXX Funktionen werden von Dxgkrnl implementiert. Um diese Rückruffunktion zu verwenden, rufen Sie DxgkCbMultiPlaneOverlayDisabled über die DXGKRNL_INTERFACE auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1607 (WDDM 2.1) |
| Zielplattform | Windows |
| Kopfzeile | d3dkmddi.h |
| IRQL | <= PASSIVE_LEVEL |