PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK回呼函式 (wdm.h)

ComponentCriticalTransitionCallback 回呼例程會處理 F0 (完全在) 和低電源 Fx 元件電源狀態之間轉換指定的元件。

語法

PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK PoFxComponentCriticalTransitionCallback;

void PoFxComponentCriticalTransitionCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Active
)
{...}

參數

[in] Context

裝置內容的指標。 設備驅動器會使用此內容來儲存裝置目前電源狀態的相關信息。 此內容是驅動程式定義的，而且不透明於PoFx。 驅動程式會在PO_FX_CORE_DEVICE結構的 DeviceContext 成員中指定此指標，驅動程式用來向 Windows 電源管理架構註冊裝置 ( PoFx) 。

[in] Component

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

[in] Active

指出此通知是否要轉換至 F0 元件電源狀態。 如果為 TRUE，則元件剛完成從低電量 Fx 狀態轉換為 F0 的轉換。 如果為 FALSE，則元件即將開始從 F0 轉換為低電源 Fx 狀態。

傳回值

無

備註

此回呼例程是由設備驅動器實作，並由PoFx呼叫。 PoFx 會呼叫此例程，以通知驅動程式裝置元件的電源轉換。

PO_FX_CORE_DEVICE 結構的 ComponentCriticalTransitionCallback 成員是 ComponentCriticalTransitionCallback 回呼例程的指標。 PO_FX_CORE_DEVICE結構的指標會當做 PoFxRegisterCoreDevice 呼叫中的輸入參數傳遞，以向 Windows 電源管理架構註冊核心裝置， (PoFx) 。

若要處理此例程的呼叫，設備驅動器會儲存或還原裝置中指定元件之緩存器狀態或其他硬體內容。

如果 Active = TRUE，則 PoFx 在元件完成從低電量 Fx 狀態轉換到 F0 之後呼叫此例程。 在此呼叫中，例程會還原先前儲存的硬體內容元件。

如果 Active = FALSE，則 PoFx 在元件開始從 F0 到低電源 Fx 狀態的暫止轉換之前，已呼叫此例程。 在此呼叫中，例程會儲存元件的硬體內容，以便稍後可以還原此內容。

如需 Fx 元件電源狀態的詳細資訊，請參閱 元件層級電源管理。

規格需求

另請參閱

PO_FX_CORE_DEVICE