DXGIDisableVBlankVirtualization-Funktion (dxgi1_6.h)

  • Artikel

Deaktiviert die V-Blank-Virtualisierung für den Prozess. Diese Virtualisierung wird standardmäßig von der DrR-Funktion (Dynamic Refresh Rate, dynamische Aktualisierungsrate) für alle Swapchains verwendet, um eine stabile virtualisierte aktuelle Rate und einen V-Blank-Rhythmus von IDXGIOutput::WaitForVBlank beizubehalten. Durch deaktivieren der Virtualisierung wird für diese APIs die sich ändernde Aktualisierungsrate angezeigt.

Syntax

HRESULT DXGIDisableVBlankVirtualization();

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls ein Fehlercode. Eine vollständige Liste der Fehlercodes finden Sie unter DXGI_ERROR.

Hinweise

Standardmäßig kann eine DXGI-Swapkette die sich ändernde Aktualisierungsrate nicht beobachten, die durch das Feature dynamische Aktualisierungsrate (DRR) verursacht wird (siehe Blogbeitrag Dynamische Aktualisierungsrate – Das Beste aus beiden Welten abrufen). Stattdessen wird eine Swapchain virtualisiert, um immer einen Bruchteil der Aktualisierungsrate anzuzeigen – 60Hz, wenn der DRR-Modus 120Hz ist. DXGIDisableVBlankVirtualization deaktiviert diese Virtualisierung für den gesamten Prozess. Ihre Anwendung sieht dann, dass sich die V-Leerlaufzeiten ändern, wenn das System zwischen 60Hz und 120Hz ankurbelt, und Frames werden zu den entsprechenden Zeiten für jede Rate eintreffen, wobei die aktuellen Statistiken diese Änderungen widerspiegeln.

Sie sollten DXGIDisableVBlankVirtualization einmal pro Prozess aufrufen, bevor Sie Swap chains erstellen oder IDXGIOutput::WaitForVBlank aufrufen. Es kann nicht für die Lebensdauer des Prozesses deaktiviert werden, sodass alle Änderungen am V-Leerzeichen-Timing oder bei statistiken aus der DRR-Verstärkung für den Prozess beobachtbar bleiben.

Weitere Informationen zur Funktionsweise der dynamischen Aktualisierungsrate finden Sie im Thema Compositor Clock .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11, Version 22502 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 11, Version 22502 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile dxgi1_6.h
Bibliothek dxgi.lib
DLL dxgi.dll

Weitere Informationen