Edit

Share via

DCOMPOSITION_FRAME_STATISTICS structure (dcomptypes.h)

  • Article

Describes timing and composition statistics for a frame.

Syntax

typedef struct {
  LARGE_INTEGER lastFrameTime;
  DXGI_RATIONAL currentCompositionRate;
  LARGE_INTEGER currentTime;
  LARGE_INTEGER timeFrequency;
  LARGE_INTEGER nextEstimatedFrameTime;
} DCOMPOSITION_FRAME_STATISTICS;

Members

lastFrameTime

Type: LARGE_INTEGER

The time stamp of the last batch of commands to be processed by the composition engine.

currentCompositionRate

Type: DXGI_RATIONAL

The rate at which the composition engine is producing frames, in frames per second.

currentTime

Type: LARGE_INTEGER

The current time as computed by the QueryPerformanceCounter function.

timeFrequency

Type: LARGE_INTEGER

The units in which the lastFrameTime and currentTime members are specified, in Hertz.

nextEstimatedFrameTime

Type: LARGE_INTEGER

The estimated time when the next frame will be displayed.

Remarks

The IDCompositionDevice::GetFrameStatistics method fills this structure. An application can use the information in this structure to estimate the timestamp of the next few frames that will be started by the composition engine. Note that this is only an estimate because the composition engine may or may not compose the next frame, depending on whether any active animations or other work are pending for that frame. In addition, the composition engine may change frame rates according to the cost of composing individual frames.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Header dcomptypes.h

See also

IDCompositionDevice::GetFrameStatistics