DXGKCB_SETPOWERCOMPONENTRESIDENCY回呼函式 (d3dkmddi.h)

內核模式顯示迷你埠驅動程式會 呼叫 DXGKCB_SETPOWERCOMPONENTRESIDENCY ，以設定類型 為 DXGK_POWER_COMPONENT_OTHER 電源元件的預期落地。

語法

DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;

void DxgkcbSetpowercomponentresidency(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex,
  [in] ULONGLONG Residency
)
{...}

參數

[in] hAdapter

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

[in] ComponentIndex

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

[in] Residency

預期的落地 — 最大時間，以 100 奈秒為單位，顯示迷你埠驅動程式預期電源元件在進入閑置狀態之後仍維持閑置狀態。 Power Management Framework 會使用這項資訊，為不違反要求落地的元件選取適當的閑置狀態。 落地所指定的預期落地會維持有效狀態，直到驅動程式再次呼叫此函式以更新它為止。 請參閱＜備註＞。

傳回值

無

備註

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

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

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

規格需求

另請參閱

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice