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。 驅動程式在 DeviceContextPO_FX_CORE_DEVICE 結構的成員中指定此指標,驅動程式用來向 Windows 電源管理架構註冊裝置 (PoFx)。
[in] Component
識別元件的索引。 此參數是裝置驅動程式用來向PoFx註冊裝置之 PO_FX_CORE_DEVICE 結構中 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 元件電源狀態的詳細資訊,請參閱 Component-Level Power Management。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 10 開始支援。 |
目標平臺 | 窗戶 |
標頭 | wdm.h (包括 Wudfwdm.h) |