PFND3DDDI_CHECKDIRECTFLIPSUPPORT Rückruffunktion (d3dumddi.h)

Artikel
02/06/2025

Wird vom Desktop Window Manager (DWM) aufgerufen, um zu überprüfen, ob der Benutzermodustreiber Direct Flip-Vorgänge unterstützt, bei denen der Videospeicher nahtlos zwischen den verwalteten primären Zuordnungen einer Anwendung und den verwalteten primären Zuordnungen des DWM gekippt wird.

Syntax

PFND3DDDI_CHECKDIRECTFLIPSUPPORT Pfnd3dddiCheckdirectflipsupport;

HRESULT Pfnd3dddiCheckdirectflipsupport(
  HANDLE hDevice,
  D3DDDIARG_CHECKDIRECTFLIPSUPPORT *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

pData- [in, out]

Ein Zeiger auf eine D3DDDIARG_CHECKDIRECTFLIPSUPPORT Struktur, die die Parameter für den Vorgang definiert.

Rückgabewert

Gibt S_OK oder ein entsprechendes Fehlerergebnis zurück, wenn der Vorgang nicht erfolgreich ausgeführt wurde.

Bemerkungen

Diese Funktion wird mindestens einmal aufgerufen, bevor der DWM versucht, eine Direct Flip-Swapchain darzustellen. Sie wird auch aufgerufen, nachdem jede Modusänderung erfolgt, oder nachdem der DWM aus irgendeinem Grund seine eigene Swapchain neu erstellt hat.

Der Benutzermodustreiber sollte sicherstellen, dass die verwalteten primären Zuordnungen der Anwendung und der DWM über die folgenden kompatiblen Ressourcen verfügen:

Stereoressourcen.
Mehrere MSAA-Formate (Sample Anti Aliasing).
Swizzle-Formate. Wenn der Swizzle nur in jedem VSync-Intervall geändert werden kann, stellen Sie sicher, dass das CheckDirectFlipFlags- element der D3DDDI_CHECK_DIRECT_FLIP_FLAGS-Struktur keinen Wert von D3D11_1DDI_CHECK_DIRECT_FLIP_IMMEDIATEaufweist.
Beide verwalteten primären Zuordnungen sollten mit demselben VidPnSourceId- Wert in der D3DDDI_ALLOCATIONINFO-Struktur erstellt werden.
Anzeigeadapterkonfigurationen sind verknüpft.

Möglicherweise muss der Benutzermodustreiber den Kernelmodustreiber aufrufen, um diese Überprüfungen durchzuführen. Rufen Sie dazu die pfnEscapeCb- Rückruffunktion auf, und rufen Sie dann die DxgkCbGetHandleData--Funktion auf, um auf die Ressourcenzuordnungsdaten des Kernelmodustreibers zuzugreifen.

Da der DWM in der Regel ein eigenes Gerät mit der größtmöglichen Microsoft Direct3D-Featureebene erstellt, ruft die DWM diese Funktion nicht auf, wenn die Hardware eine Direct3D-Gerätetreiberschnittstelle (Direct3D Device Driver Interface, DDI) unterstützt, die größer als Version 9.3 ist. Jeder Microsoft Direct3D 9-Treiber sollte diese Funktion jedoch implementieren, um die Direct Flip-Benutzeroberfläche zu aktivieren.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Desktop
Header-	d3dumddi.h (include D3dumddi.h)

Siehe auch

D3DDDI_CHECK_DIRECT_FLIP_FLAGS

D3DDDI_DEVICEFUNCS

Freigeben über