DXGKARG_HISTORYBUFFERPRECISION 結構 (d3dkmddi.h)

指出顯示迷你埠驅動程式所使用之歷程記錄緩衝區數據精確度的相關信息。

語法

typedef struct _DXGKARG_HISTORYBUFFERPRECISION {
  UINT32 PrecisionBits;
} DXGKARG_HISTORYBUFFERPRECISION;

PrecisionBits

每個時間戳中使用的有效位數目。此數位不包含用於垃圾郵件值的位。

這個有效位數值有三個有效範圍：

ReplTest1	意義
0	沒有任何位包含有用的數據，而 DirectX 圖形核心子系統會呼叫 DxgkDdiFormatHistoryBuffer 函式，以提供有效的數據來輸出給 Windows (ETW 事件追蹤) 設施。當驅動程式處理此呼叫時，它會將新的有效位數值設定為函式的輸出參數。
32	驅動程式應該使用完整的 32 位有效位數來記錄 32 位時間戳。
33–64	驅動程式應該記錄 64 位時間戳。這個值會定義用來儲存每個時間戳數據的位數。為了降低格式化數據的成本，驅動程式可以在64位時間戳中包含垃圾郵件值。例如，驅動程式可以寫入具有55個有效位數有效位數的64位時間戳。在此情況下，大 9 位會被視為垃圾郵件值，而且會由 ETW 移除。

不支援介於 0 和 32 之間的值，且無效。

如果硬體支援 64 位時間戳，但只能使用 32 位，驅動程式必須確保數據正確呈現給 DirectX 圖形核心子系統。如果驅動程式沒有其他替代方案來呈現數據，則下次呼叫 DxgkDdiFormatHistoryBuffer 函式時，它應該提供有效位數值。

在對 DxgkDdiQueryAdapterInfo 函式的呼叫中，輸出數據大小 DXGKARG_QUERYADAPTERINFO。OutputDataSize 為：

sizeof(DXGKARG_HISTORYBUFFERPRECISION) * m_DriverCaps.GpuEngineTopology.NbAsymetricProcessingNodes