структура DXGK_HISTORY_BUFFER_HEADER (d3dkmddi.h)

Статья
02/06/2025

Указывает, как данные хранятся в буфере журнала DXGK_HISTORY_BUFFER.

Синтаксис

typedef struct _DXGK_HISTORY_BUFFER_HEADER {
  UINT32 RenderCbSequence;
  UINT32 NumTimestamps;
  UINT32 PrivateDataSize;
  UINT32 Reserved;
} DXGK_HISTORY_BUFFER_HEADER;

Члены

RenderCbSequence

Значение D3DDDICB_RENDERFLAGS.член значения, который должен использоваться в вызове функции pfnRenderCb.

Драйвер минипорта отображения должен вычислить это значение и ввести его в DXGK_HISTORY_BUFFER_HEADER перед вызовом pfnRenderCb.

NumTimestamps

Количество меток времени, которые будут находиться в буфере журнала при завершении выполнения буфера DMA.

Драйвер должен включать все метки времени, которые регистрируются, даже если буфер должен быть отформатирован перед записью в объект трассировки событий для Windows (ETW).

PrivateDataSize

Размер (в байтах) необязательных частных данных, которые хранит драйвер. Драйвер может использовать эти данные для любой цели.

Если ноль, драйвер не должен хранить частные данные в буфере журнала.

Примечание Это значение должно иметь несколько 8 байт, чтобы обеспечить выравнивание данных метки времени на 64-разрядную границу.

Если буфер журнала не должен быть отформатирован при завершении выполнения буфера DMA, то когда подсистема ядра графики DirectX записывает журналы в ETW, она использует PrivateDataSize в качестве прямого смещения от заголовка для ссылки на метки времени.

Reserved

Зарезервировано для использования системы и должно быть равно нулю.

Замечания

В ETW регистрируется только часть буфера журнала, а также количество меток времени. Данные заголовка и данные частного драйвера не записываются в ETW в рамках буфера метки времени. Однако части заголовка будут регистрироваться отдельно.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8.1,WDDM 1.3 и более поздних версий
минимальный поддерживаемый сервер	Windows Server 2012 R2
заголовка	d3dkmddi.h (include D3dkmddi.h)

См. также

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb

Поделиться через