DXGKCB_SETPOWERCOMPONENTLATENCY回呼函式 (d3dkmddi.h)

  • 發行項

顯示迷你埠驅動程式會呼叫 DXGKCB_SETPOWERCOMPONENTLATENCY ，以設定類型 DXGK_POWER_COMPONENT_OTHER電源元件的延遲容錯。

語法

DXGKCB_SETPOWERCOMPONENTLATENCY DxgkcbSetpowercomponentlatency;

void DxgkcbSetpowercomponentlatency(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex,
  [in] ULONGLONG Latency
)
{...}

參數

[in] hAdapter

顯示配接器的句柄。 顯示迷你埠驅動程式會在呼叫其 DxgkDdiStartDevice 函式時，從 DXGKRNL_INTERFACE 結構的 DeviceHandle 成員接收句柄。

[in] ComponentIndex

DXGKARG_QUERYADAPTERINFO指定的電源元件索引。pInputData 在對 DxgkDdiQueryAdapterInfo 函式的呼叫中。

[in] Latency

延遲容錯 — 最大時間，以 100 奈秒為單位—顯示迷你埠驅動程式應該從閑置狀態喚醒電源元件。 Power Management Framework 會使用這項資訊，為未違反要求延遲容錯的元件選取適當的閑置狀態。 延遲指定的延遲容錯會維持有效狀態，直到驅動程式再次呼叫此函式以更新它為止。 請參閱＜備註＞。

傳回值

無

備註

注意

只有在元件類型 DXGK_POWER_COMPONENT_OTHER時，顯示迷你埠驅動程式才應該呼叫此函式。 DirectX 圖形核心子系統會設定其他元件類型的延遲容錯值。

DXGKCB_XXX 函式是由 Dxgkrnl 實作。 若要使用此回呼函式，請透過 DXGKRNL_INTERFACE呼叫 DxgkCbSetPowerComponentLatency。

如果呼叫此函式時電源元件處於閑置狀態， Power Management Framework 可能會變更元件的 F 狀態，以符合 延遲所指定的延遲容錯。

如果驅動程式將延遲設定為 Wdm.h) 中定義的PO_FX_UNKNOWN_TIME (值，Power Engine 外掛程式 (PEP) 可能無法將元件設定為低於 F0 的 F 狀態。

規格需求

需求 值
最低支援的用戶端 Windows 8 (WDDM 1.2)
最低支援的伺服器 Windows Server 2012
目標平台 桌面
標頭 d3dkmddi.h (include D3dkmddi.h)
IRQL <= DISPATCH_LEVEL

另請參閱

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice