共用方式為


DXGKARG_FORMATHISTORYBUFFER結構(d3dkmddi.h)

包含顯示迷你埠驅動程式格式化歷程記錄緩衝區的資訊。

語法

typedef struct _DXGKARG_FORMATHISTORYBUFFER {
  DXGK_HISTORY_BUFFER            *pHistoryBuffer;
  UINT32                         HistoryBufferSize;
  PVOID                          pFormattedBuffer;
  UINT32                         FormattedBufferSize;
  UINT32                         NumTimestamps;
  DXGKARG_HISTORYBUFFERPRECISION Precision;
  UINT32                         Offset;
} DXGKARG_FORMATHISTORYBUFFER;

成員

pHistoryBuffer

GPU 所填入之未格式化 DXGK_HISTORY_BUFFER 歷程記錄緩衝區的指標。

HistoryBufferSize

pHistoryBuffer 所指向之緩衝區的大小,以位元組為單位,

pFormattedBuffer

驅動程式用來儲存其衍生自所提供未格式化歷程記錄緩衝區的時間戳資訊之非分頁系統記憶體區段的指標。

pFormattedBuffer 所指向的緩衝區,應以 Precision所指定的大量時間戳來管理。 緩衝區不應包含原始歷程記錄緩衝區中已存在的任何標頭資訊。

FormattedBufferSize

pFormattedBuffer 所指向之緩衝區的大小,以位元組為單位,。 驅動程式應該確保不會寫入超過此緩衝區大小的數據。

NumTimestamps

時間戳的數目。 完成對 DxgkDdiFormatHistoryBuffer 函式的呼叫時,驅動程式應將此值設定為寫入 pFormattedBuffer 所指向之格式化緩衝區的時間戳數目,

請注意,在驅動程式完成 pFormattedBuffer 所指向的格式化緩衝區之前,將不會知道格式化輸出緩衝區中的時間戳數目

Precision

驅動程式會填入時間戳精確度的 DXGKARG_HISTORYBUFFERPRECISION 結構,該時間戳的精確度會記錄到 Windows 事件追蹤 (ETW) 設施。

DXGKARG_HISTORYBUFFERPRECISION的值。PrecisionBits 成員不可以是零。

Offset

在呼叫 DxgkDdiFormatHistoryBuffer 函式的輸入時,這個成員的值是格式設定應該開始的第一個時間戳位移。 在函式呼叫完成時,如果驅動程式已成功格式化歷程記錄緩衝區中的所有時間戳,則驅動程式應該將值設定為零。

如果非零,則驅動程式無法格式化歷程記錄緩衝區中的所有時間戳,而不需要填入格式化的緩衝區。 在此情況下,值代表應該在下一個函數調用中繼續的位移。

言論

驅動程式應該從提供的歷程記錄緩衝區標頭取得時間戳專案和可用時間戳的數目。 驅動程序計算所需的任何其他數據都應該儲存在私人數據中。

要求

要求 價值
最低支援的用戶端 Windows 8.1、WDDM 1.3 及更新版本
支援的最低伺服器 Windows Server 2012 R2
標頭 d3dkmddi.h (包括 D3dkmddi.h)

另請參閱

DXGKARG_HISTORYBUFFERPRECISION

DXGK_HISTORY_BUFFER

DxgkDdiFormatHistoryBuffer