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 適配卡物件的句柄。
顯示迷你埠驅動程式先前已提供此句柄給 MiniportDeviceContextDxgkDdiAddDevice 函式的 DirectX 圖形核心子系統。
NodeOrdinal
將取得計時校正信息的節點索引。 此節點位於 hAdapter 參數所定義的實體配接器內。
EngineOrdinal
以零起始的引擎索引,在 nodeOrdinal 所指定的節點內,將會取得計時校正資訊。 對於鏈接顯示配接器 (LDA) 組態中不屬於連結的圖形配接器,您應該一律將 engineOrdinal 設定為 0。
pClockCalibration
DXGKARG_CALIBRATEGPUCLOCK 結構的指標,提供來自 GPU 和 CPU 的時鐘計數器資訊。
傳回值
如果成功,則傳回 STATUS_SUCCESS;否則,它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。
言論
DirectX 圖形核心子系統會使用 pClockCalibration 參數中傳回的信息來估計 GPU 與 CPU 時鐘之間的漂移。
為了將校正不明確程度降到最低,驅動程式應該計算 GpuClockCounter 的值,並盡可能 CpuClockCounterDXGKARG_CALIBRATEGPUCLOCK 結構的成員。
DirectX 圖形核心子系統經常呼叫此函式,通常至少每 30 毫秒一次,以將 GPU 和 CPU 時鐘之間的累積漂移降到最低。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 8.1,WDDM 1.3 |
支援的最低伺服器 | Windows Server 2012 R2 |
目標平臺 | 桌面 |
標頭 | d3dkmddi.h |
IRQL | DISPATCH_LEVEL |