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

  • Статья

Указывает, как данные хранятся в буфере журнала 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 (включая D3dkmddi.h)

См. также раздел

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb