D3DKMT_PRESENT_STATS structure (d3dkmthk.h)
The D3DKMT_PRESENT_STATS structure describes present status for a rendering device.
Syntax
typedef struct _D3DKMT_PRESENT_STATS {
[out] UINT PresentCount;
[out] UINT PresentRefreshCount;
[out] UINT SyncRefreshCount;
[out] D3DKMT_ALIGN64 LARGE_INTEGER SyncQPCTime;
[out] D3DKMT_ALIGN64 LARGE_INTEGER SyncGPUTime;
} D3DKMT_PRESENT_STATS;
Members
[out] PresentCount
A UINT value that indicates the number of times that the OpenGL installable client driver (ICD) called the D3DKMTPresent function on a rendering device or swap chain. After the maximum value is reached, PresentCount starts over at zero. When a new rendering device is created, PresentCount is initialized to zero. The operating system maintains a present counter for each swap chain that is created.
[out] PresentRefreshCount
A UINT value that indicates the number of times the display controller outputs a new video frame, which occurs at the beginning of each vertical retrace period. The operating system maintains a present refresh counter for each video display controller output in the operating system. PresentRefreshCount is initialized to an unspecified value.
[out] SyncRefreshCount
A UINT value that indicates the number of the most recent capture of the timing information in the SyncQPCTime and SyncGPUTime members.
[out] SyncQPCTime
The computer processing unit (CPU) time that the current video frame was output at (that is, the CPU time that the vertical retrace started).
[out] SyncGPUTime
The graphics processing unit (GPU) time that the current video frame was output at (that is, the GPU time that the vertical retrace started).
Remarks
When a present operation is retired, the operating system maintains a correspondence (mapping) between the value in PresentCount and the value in PresentRefreshCount; that is, when the operating system finishes a present operation as a scanned out video frame, the value in PresentRefreshCount that the present operation was finished with is associated with the value in PresentCount of the retired present operation.
The operating system maintains timing information within a rendering device and associates the timing information with a display output. When the GPU can maintain the GPU time (SyncGPUTime), the GPU time operates at a device-specific frequency. To let applications relate GPU time to other operations in the system, the operating system maintains a correspondence between GPU time and CPU time (SyncQPCTime). When the GPU cannot maintain such GPU time, the operating system maintains only CPU time and the associated GPU time is always zero.
Present statistics cannot work for windowed-mode devices. For windowed mode, each structure member is set to zero.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Header | d3dkmthk.h (include D3dkmthk.h) |