poFxSetComponentResidency 函式 (wdm.h)

PoFxSetComponentResidency 例程會設定元件在進入閑置條件之後，元件可能維持閑置時間的估計時間。

語法

void PoFxSetComponentResidency(
  [in] POHANDLE  Handle,
  [in] ULONG     Component,
  [in] ULONGLONG Residency
);

[in] Handle

句柄，表示使用電源管理架構註冊裝置， (PoFx) 。設備驅動器先前已從 PoFxRegisterDevice 例程收到此句柄。

[in] Component

識別元件的索引。此參數是裝置驅動程式用來向PoFx註冊裝置之PO_FX_DEVICE結構中 Components 陣列的索引。如果 Components 陣列包含 N 個元素，元件索引的範圍從 0 到 N–1。

[in] Residency

預估落地時間，以 100 奈秒為單位。此參數是 PoFx 的提示，說明元件在從使用中條件轉換到閑置條件之後，可能保持閑置的時間長度。如需詳細資訊，請參閱＜備註＞。

無

呼叫驅動程式會提供PoFx可用來做為改善效能的提示的估計落地時間。 PoFx 會使用此提示，為處於閑置條件的元件選取適當的低電源 Fx 狀態。

裝置驅動程式可以在每次情況變更時呼叫 PoFxSetComponentResidency ，而需要預估落地時間的變更。每次呼叫之後，新的估計落地時間會維持有效狀態，直到驅動程式再次呼叫 PoFxSetComponentResidency 以更新它為止。

如果在呼叫 PoFxSetComponentResidency 時元件處於閑置狀態，PoFx 可能會變更元件的 Fx 狀態，以容納呼叫端所指定的新估計落地時間。