DXGI_FRAME_STATISTICS 構造体 (dxgi.h)

  • [アーティクル]

フレームのタイミングとプレゼンテーションの統計情報について説明します。

構文

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

メンバー

PresentCount

型: UINT

コンピューターの起動後にイメージがモニターに表示された実行時間の合計回数を表す 値です。

メモ イメージがモニターに表示された回数は、 IDXGISwapChain::P resent または IDXGISwapChain1::Present1 を呼び出した回数と必ずしも同じではありません。
 

PresentRefreshCount

型: UINT

最後のイメージがモニターに表示され、コンピューターの起動後に発生した v ブランクの実行中の合計カウントを表す値 (スワップ チェーンが作成されてからウィンドウ モードの場合)。

SyncRefreshCount

型: UINT

スケジューラが QueryPerformanceCounter を呼び出してマシン時間を最後にサンプリングしたとき、およびコンピューターの起動後に発生した (スワップ チェーンが作成された後のウィンドウ モードの場合) v-blanks の実行総数を表す 値。

SyncQPCTime

種類: LARGE_INTEGER

高解像度パフォーマンス カウンター タイマーを表す 値。 この値は、 QueryPerformanceCounter 関数によって返される値と同じです。

SyncGPUTime

種類: LARGE_INTEGER

予約済み。 常に 0 を返します。

Remarks

IDXGIOutput::GetFrameStatistics メソッドまたは IDXGISwapChain::GetFrameStatistics メソッドを使用して、DXGI_FRAME_STATISTICS構造体を初期化します。

IDXGISwapChain::GetFrameStatistics は、反転プレゼンテーション モデルを使用するか、全画面表示モードで描画するスワップ チェーンにのみ使用できます。 スワップ チェーンで反転プレゼンテーション モデルを使用するように指定するには、DXGI_SWAP_CHAIN_DESC1構造体の SwapEffect メンバーにDXGI_SWAP_EFFECT_FLIP_SEQUENTIAL値を設定します。

PresentCount メンバーと PresentRefreshCount メンバーの値は、フレームが表示画面に表示された日時に関する情報を示します。 これらの値を使用して、不具合が発生したかどうかを判断できます。 SyncRefreshCount メンバーと SyncQPCTime メンバーの値は、オーディオとビデオの同期や非常に正確なアニメーションに使用できるタイミング情報を示します。 スワップ チェーンが全画面表示モードで描画される場合、これらの値はコンピューターの起動時に基づいています。 スワップ チェーンがウィンドウ モードで描画される場合、これらの値はスワップ チェーンの作成時に基づいています。

要件

要件 値
Header dxgi.h

こちらもご覧ください

DXGI 構造体