Edit

DXGI_FRAME_STATISTICS_MEDIA structure (dxgi1_3.h)

  • Article

Used to verify system approval for the app's custom present duration (custom refresh rate). Approval should be continuously verified on a frame-by-frame basis.

Syntax

typedef struct DXGI_FRAME_STATISTICS_MEDIA {
  UINT                         PresentCount;
  UINT                         PresentRefreshCount;
  UINT                         SyncRefreshCount;
  LARGE_INTEGER                SyncQPCTime;
  LARGE_INTEGER                SyncGPUTime;
  DXGI_FRAME_PRESENTATION_MODE CompositionMode;
  UINT                         ApprovedPresentDuration;
} DXGI_FRAME_STATISTICS_MEDIA;

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.

CompositionMode

Type: DXGI_FRAME_PRESENTATION_MODE

A value indicating the composition presentation mode. This value is used to determine whether the app should continue to use the decode swap chain. See DXGI_FRAME_PRESENTATION_MODE.

ApprovedPresentDuration

Type: UINT

If the system approves an app's custom present duration request, this field is set to the approved custom present duration.

If the app's custom present duration request is not approved, this field is set to zero.

Remarks

This structure is used with the GetFrameStatisticsMedia method.

Requirements

Requirement Value
Header dxgi1_3.h

See also

DXGI Structures

IDXGISwapChainMedia