共用方式為


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

另請參閱

DXGKARG_CALIBRATEGPUCLOCK

DXGK_HISTORY_BUFFER

DxgkDdiAddDevice