DXGI_FRAME_STATISTICS-Struktur (dxgi.h)

  • Artikel

Beschreibt die Zeit- und Präsentationsstatistik für einen Frame.

Syntax

typedef struct DXGI_FRAME_STATISTICS {
  UINT          PresentCount;
  UINT          PresentRefreshCount;
  UINT          SyncRefreshCount;
  LARGE_INTEGER SyncQPCTime;
  LARGE_INTEGER SyncGPUTime;
} DXGI_FRAME_STATISTICS;

Member

PresentCount

Typ: UINT

Ein -Wert, der die Anzahl der ausgeführten Gesamtanzahlen darstellt, die ein Image seit dem Start des Computers für den Monitor angezeigt wurde.

Hinweis Die Häufigkeit, mit der ein Bild dem Monitor angezeigt wurde, entspricht nicht unbedingt der Anzahl der Aufrufe von IDXGISwapChain::P resent oder IDXGISwapChain1::P resent1.
 

PresentRefreshCount

Typ: UINT

Ein Wert, der die Anzahl der ausgeführten V-Leerzeichen darstellt, bei denen das letzte Image dem Monitor angezeigt wurde und die seit dem Start des Computers aufgetreten sind (im Fenstermodus, da die Swapchain erstellt wurde).

SyncRefreshCount

Typ: UINT

Ein Wert, der die Gesamtzahl der ausgeführten V-Leerzeichen darstellt, als der Planer die Computerzeit zuletzt durch Aufrufen von QueryPerformanceCounter abgetastet hat und die seit dem Start des Computers aufgetreten sind (im Fenstermodus, da die Swapchain erstellt wurde).

SyncQPCTime

Typ: LARGE_INTEGER

Ein Wert, der den hochauflösenden Leistungsindikatortimer darstellt. Dieser Wert ist mit dem wert identisch, der von der QueryPerformanceCounter-Funktion zurückgegeben wird.

SyncGPUTime

Typ: LARGE_INTEGER

Reserviert. Es wird immer 0 zurückgegeben.

Hinweise

Sie initialisieren die DXGI_FRAME_STATISTICS-Struktur mit der IDXGIOutput::GetFrameStatistics- oder IDXGISwapChain::GetFrameStatistics-Methode.

Sie können IDXGISwapChain::GetFrameStatistics nur für Swap chains verwenden, die entweder das Flip-Präsentationsmodell verwenden oder im Vollbildmodus zeichnen. Sie legen den DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL-Wert im SwapEffect-Member der DXGI_SWAP_CHAIN_DESC1-Struktur fest, um anzugeben, dass die Swapchain das Flip-Präsentationsmodell verwendet.

Die Werte in den Membern PresentCount und PresentRefreshCount geben Informationen darüber an, wann ein Frame auf dem Bildschirm angezeigt wurde. Mit diesen Werten können Sie ermitteln, ob ein Fehler aufgetreten ist. Die Werte in den Membern SyncRefreshCount und SyncQPCTime geben Zeitinformationen an, die Sie für die Audio- und Videosynchronisierung oder sehr präzise Animation verwenden können. Wenn die Swapchain im Vollbildmodus zeichnet, basieren diese Werte darauf, wann der Computer gestartet wurde. Wenn die Swapchain im Fenstermodus zeichnet, basieren diese Werte darauf, wann die Swapchain erstellt wird.

Anforderungen

Anforderung Wert
Header dxgi.h

Weitere Informationen

DXGI-Strukturen