IDXGISwapChain2::GetFrameLatencyWaitableObject-Methode (dxgi1_3.h)

Gibt einen wartebaren Handle zurück, der signalisiert, wenn der DXGI-Adapter mit der Präsentation eines neuen Frames fertig ist.

Windows 8.1 führt neue APIs ein, die das Rendern mit geringerer Latenz ermöglichen, indem sie warten, bis der vorherige Frame der Anzeige angezeigt wird, bevor sie den nächsten Frame zeichnen. Um diese Methode zu verwenden, erstellen Sie zuerst die DXGI-Swapkette mit dem DXGI_SWAP_CHAIN_FLAG_FRAME_LATENCY_WAITABLE_OBJECT-Flag , und rufen Sie dann GetFrameLatencyWaitableObject auf, um das wartebare Handle abzurufen. Verwenden Sie das wartebare Handle mit WaitForSingleObjectEx , um das Rendering jedes neuen Frames mit dem Ende des vorherigen Frames zu synchronisieren. Für jeden Frame, den sie rendert, sollte die App auf dieses Handle warten, bevor sie Renderingvorgänge startet. Beachten Sie, dass diese Anforderung den ersten Frame umfasst, den die App mit der Swapchain rendert. Weitere Informationen finden Sie im DirectXLatency-Beispiel. Wenn Sie mit dem Handle fertig sind, verwenden Sie CloseHandle , um es zu schließen.

Syntax

HANDLE GetFrameLatencyWaitableObject();

Rückgabewert

Ein Handle für das wartebare Objekt oder NULL, wenn die Swapchain nicht mit DXGI_SWAP_CHAIN_FLAG_FRAME_LATENCY_WAITABLE_OBJECT erstellt wurde.

Hinweise

Wenn eine Anwendung das Objekthandle verwendet, das von IDXGISwapChain2::GetFrameLatencyWaitableObject zurückgegeben wird, verwenden Sie die CloseHandle-Funktion , um das Handle zu schließen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8.1 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	dxgi1_3.h
Bibliothek	Dxgi.lib

Weitere Informationen

DirectX-Latenzbeispiel

GetMaximumFrameLatency

IDXGISwapChain2

SetMaximumFrameLatency