DXGKDDI_CALIBRATEGPUCLOCK回呼函式 (d3dkmddi.h)
由 Microsoft DirectX 圖形核心子系統呼叫，以使用 CPU 時鐘時間校正 DXGK_HISTORY_BUFFER 歷程記錄緩衝區中的 GPU 時間戳。
語法
DXGKDDI_CALIBRATEGPUCLOCK DxgkddiCalibrategpuclock;
NTSTATUS DxgkddiCalibrategpuclock(
IN_CONST_HANDLE hAdapter,
IN UINT32 NodeOrdinal,
IN UINT32 EngineOrdinal,
OUT_PDXGKARG_CALIBRATEGPUCLOCK pClockCalibration
)
{...}
參數
hAdapter
要取得計時校正資訊的 GPU 配接器物件的句柄。
顯示迷你埠驅動程式先前已將此句柄提供給 DxgkDdiAddDevice 函式之 MiniportDeviceContext 輸出參數中的 DirectX 圖形核心子系統。
NodeOrdinal
取得計時校正信息的節點索引。 此節點位於 hAdapter 參數所定義的實體配接器內。
EngineOrdinal
NodeOrdinal 所指定的節點內，引擎以零起始的索引，將會取得計時校正資訊。 對於鏈接顯示配接器中不屬於連結的圖形配接器， (LDA) 組態，您應該一律將 EngineOrdinal 設定為 0。
pClockCalibration
DXGKARG_CALIBRATEGPUCLOCK 結構的指標 ，提供 GPU 和 CPU 的時鐘計數器資訊。
傳回值
如果成功 ， 則傳回STATUS_SUCCESS;否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。
備註
DirectX 圖形核心子系統會使用 pClockCalibration 參數中的傳回資訊來估計 GPU 與 CPU 時鐘之間的漂移。
若要將校正不透明度降到最低，驅動程式應該盡可能計算DXGKARG_CALIBRATEGPUCLOCK結構之 GpuClockCounter 和 CpuClockCounter 成員的值。
DirectX 圖形核心子系統經常呼叫此函式，通常至少每 30 毫秒一次，以將 GPU 與 CPU 時鐘之間的累積漂移降至最低。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8.1，WDDM 1.3 |
| 最低支援的伺服器 | Windows Server 2012 R2 |
| 目標平台 | 桌面 |
| 標頭 | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |