DXGK_HISTORY_BUFFER structure (d3dkmddi.h)

Specifies a history buffer that stores time stamps that record GPU activity throughout the execution lifetime of a direct memory access (DMA) buffer.

Syntax

typedef struct _DXGK_HISTORY_BUFFER {
  DXGK_HISTORY_BUFFER_HEADER Header;
  UINT8                      DriverPrivateData[1];
} DXGK_HISTORY_BUFFER;

Members

Header

A pointer to a DXGK_HISTORY_BUFFER_HEADER structure that contains history buffer header info.

DriverPrivateData[1]

An array that marks the beginning of the optional driver data and timestamp entries. See Remarks for more info.

Remarks

You can calculate the address of the first time stamp in the history buffer by adding the value of DXGK_HISTORY_BUFFER_HEADER.PrivateDataSize to the address of DriverPrivateData.

The beginnings of the time stamps should be aligned to a 64-bit boundary.

The first and last time stamps in the DriverPrivateData array must be respectively the start and end times of the DMA buffer. Time stamps that are used to log marker times begin after this end time. This is the case for both formatted and unformatted buffers.

The driver specifies the precision of time stamps with the DXGKARG_HISTORYBUFFERPRECISION structure.

Requirements

Requirement Value
Minimum supported client Windows 8.1,WDDM 1.3 and later
Minimum supported server Windows Server 2012 R2
Header d3dkmddi.h (include D3dkmddi.h)

See also

DXGKARG_HISTORYBUFFERPRECISION

DXGK_HISTORY_BUFFER_HEADER