DXGI_FRAME_STATISTICS structure (dxgi.h)

  • Article

Describes timing and presentation statistics for a frame.

Syntax

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

Members

PresentCount

Type: UINT

A value that represents the running total count of times that an image was presented to the monitor since the computer booted.

Note  The number of times that an image was presented to the monitor is not necessarily the same as the number of times that you called IDXGISwapChain::Present or IDXGISwapChain1::Present1.
 

PresentRefreshCount

Type: UINT

A value that represents the running total count of v-blanks at which the last image was presented to the monitor and that have happened since the computer booted (for windowed mode, since the swap chain was created).

SyncRefreshCount

Type: UINT

A value that represents the running total count of v-blanks when the scheduler last sampled the machine time by calling QueryPerformanceCounter and that have happened since the computer booted (for windowed mode, since the swap chain was created).

SyncQPCTime

Type: LARGE_INTEGER

A value that represents the high-resolution performance counter timer. This value is the same as the value returned by the QueryPerformanceCounter function.

SyncGPUTime

Type: LARGE_INTEGER

Reserved. Always returns 0.

Remarks

You initialize the DXGI_FRAME_STATISTICS structure with the IDXGIOutput::GetFrameStatistics or IDXGISwapChain::GetFrameStatistics method.

You can only use IDXGISwapChain::GetFrameStatistics for swap chains that either use the flip presentation model or draw in full-screen mode. You set the DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL value in the SwapEffect member of the DXGI_SWAP_CHAIN_DESC1 structure to specify that the swap chain uses the flip presentation model.

The values in the PresentCount and PresentRefreshCount members indicate information about when a frame was presented on the display screen. You can use these values to determine whether a glitch occurred. The values in the SyncRefreshCount and SyncQPCTime members indicate timing information that you can use for audio and video synchronization or very precise animation. If the swap chain draws in full-screen mode, these values are based on when the computer booted. If the swap chain draws in windowed mode, these values are based on when the swap chain is created.

Requirements

Requirement Value
Header dxgi.h

See also

DXGI Structures