PoFxSetComponentWake 函式 (wdm.h)

PoFxSetComponentWake 例程會指出每當元件進入閑置條件時，驅動程式是否要讓指定的元件喚醒。

語法

void PoFxSetComponentWake(
  [in] POHANDLE Handle,
  [in] ULONG    Component,
  [in] BOOLEAN  WakeHint
);

[in] Handle

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

[in] Component

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

[in] WakeHint

每當元件進入閑置條件時，驅動程式是否要讓元件喚醒。如果為 TRUE，則驅動程式會使用元件來喚醒。如果為 FALSE，則驅動程式不會讓元件喚醒。

無

元件進入低電源 Fx 狀態之前，驅動程式可能會讓元件自動喚醒，以回應來自外部來源的輸入訊號 (例如，如果使用者按下按鈕) 。 WakeHint 參數會通知 PoFx 驅動程式是否要喚醒元件。如果元件處於喚醒狀態，PoFx 將不會將元件切換到元件無法喚醒的低電源 Fx 狀態。

當裝置向PoFx註冊時，裝置中每個元件的註冊資訊會包含在個別的PO_FX_COMPONENT 結構中。這個結構的 DeepestWakeableIdleState 成員會指定元件可以喚醒的最深 Fx 狀態。

裝置驅動程式可以在每次條件變更需要 WakeHint 值變更時呼叫 PoFxSetComponentWake。每次呼叫之後，新的 WakeHint 值會維持作用，直到驅動程式再次呼叫 PoFxSetComponentWake 以更新它為止。

如果在呼叫 PoFxSetComponentWake 時元件處於閑置狀態，PoFx 可能會變更元件的 Fx 狀態，以容納呼叫端所指定的新 WakeHint 參數值。