PO_FX_COMPONENT_PERF_STATE_CALLBACK回呼函式 (wdm.h)
ComponentPerfStateCallback 回呼例程會通知驅動程式,要求變更元件的效能狀態已完成。
語法
PO_FX_COMPONENT_PERF_STATE_CALLBACK PoFxComponentPerfStateCallback;
void PoFxComponentPerfStateCallback(
[in] PVOID Context,
[in] ULONG Component,
[in] BOOLEAN Succeeded,
[in] PVOID RequestContext
)
{...}
參數
[in] Context
裝置內容的指標。 設備驅動器會使用此內容來儲存裝置目前電源狀態的相關信息。 設備驅動器在 DeviceContext 中指定此指標, 驅動程式用來向電源管理架構 (PoFx) 註冊裝置之 PO_FX_DEVICE 結構的成員。 此內容與PoFx不透明。
[in] Component
指定識別元件的索引。 此參數是裝置驅動程式用來向PoFx註冊裝置之 PO_FX_DEVICE 結構中 Components 陣列中的索引。 如果 元件 數位件包含 N 個元素,元件索引的範圍從 0 到 N–1。
[in] Succeeded
如果為TRUE,平臺擴充功能外掛程式 (PEP) 會成功變更效能狀態。 如果為 FALSE,PEP 會失敗效能狀態變更。 如需詳細資訊,請參閱一節。
[in] RequestContext
PoFxIssueComponentPerfStateChange 或 PoFxIssueComponentPerfStateChange 例程 Context 參數所指定的選用驅動程式或裝置內容的指標。
傳回值
沒有
言論
當裝置驅動程式透過呼叫 PoFxIssueComponentPerfStateChange 或 PoFxIssueComponentPerfStateChangeMultiple 例程來要求效能狀態變更時,PoFx 會呼叫 ComponentPerfStateCallback 例程,以在要求完成時通知驅動程式。
若要指定 ComponentPerfStateCallback 例程,請在驅動程式向 PoFx 註冊效能狀態管理時,使用 PoFxRegisterComponentPerfStates 例程的 ComponentPerfStateCallback 参數。 ComponentPerfStateCallback 例程可能適用於所有元件和所有裝置。
如果 成功 為 TRUE,驅動程式應該執行任何必要的工作,以變更硬體中的效能狀態。 如果 成功 為 FALSE,驅動程式可以選擇執行任何動作,或重試具有相同效能狀態或替代效能狀態的要求。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 10 開始支援。 |
目標平臺 | 桌面 |
標頭 | wdm.h |
IRQL | 在 IRQL <= DISPATCH_LEVEL 呼叫。 |
另請參閱
PoFxIssueComponentPerfStateChange