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

另請參閱

DXGKARG_CALIBRATEGPUCLOCK

DXGK_HISTORY_BUFFER

DxgkDdiAddDevice