DXGIDisableVBlankVirtualization-Funktion (dxgi1_6.h)
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 |