PFND3DDDI_CHECKDIRECTFLIPSUPPORT Rückruffunktion (d3dumddi.h)

  • Artikel

Wird vom Desktopfenster-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 der DWM umgedreht wird.

Syntax

PFND3DDDI_CHECKDIRECTFLIPSUPPORT Pfnd3dddiCheckdirectflipsupport;

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

Parameter

hDevice

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

unnamedParam2

pData [ein, aus]

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.

Hinweise

Diese Funktion wird mindestens einmal aufgerufen, bevor der DWM versucht, eine Direkte Flip-Swapchain zu präsentieren. Es wird auch aufgerufen, nachdem jede Modusänderung erfolgt ist oder nachdem der DWM aus irgendeinem Grund eine eigene Swapchain neu erstellt hat.

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

  • Stereoressourcen.
  • Mehrere MSAA-Formate (Sample Anti Aliasing).
  • Swizzle-Formate. Wenn der Swizzle nur bei 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_IMMEDIATE hat.
  • Beide verwalteten primären Zuordnungen sollten mit demselben VidPnSourceId-Wert in der D3DDDI_ALLOCATIONINFO-Struktur erstellt werden.
  • Grafikkartenkonfigurationen sind verknüpft.
Der Benutzermodustreiber muss möglicherweise den Kernelmodustreiber aufrufen, um diese Überprüfungen durchzuführen. Rufen Sie hierzu die Rückruffunktion pfnEscapeCb 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 höchstmöglichen Microsoft Direct3D-Featureebene erstellt, ruft der DWM diese Funktion nicht auf, wenn die Hardware eine Direct3D-Gerätetreiberschnittstelle (DDI) unterstützt, die größer als Version 9.3 ist. Allerdings sollte jeder Microsoft Direct3D 9-Treiber diese Funktion implementieren, um die Benutzeroberfläche für direktes Spiegeln zu ermöglichen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Desktop
Kopfzeile d3dumddi.h (include D3dumddi.h)

Weitere Informationen

D3DDDI_CHECK_DIRECT_FLIP_FLAGS

D3DDDI_DEVICEFUNCS