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 函式的值成員。

顯示迷你埠驅動程序應該先計算此值，並在呼叫 pfnRenderCb 之前將其輸入DXGK_HISTORY_BUFFER_HEADER。

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