共用方式為


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

PoFxIssueComponentPerfStateChangePoFxIssueComponentPerfStateChange 例程 Context 參數所指定的選用驅動程式或裝置內容的指標。

傳回值

沒有

言論

當裝置驅動程式透過呼叫 PoFxIssueComponentPerfStateChangePoFxIssueComponentPerfStateChangeMultiple 例程來要求效能狀態變更時,PoFx 會呼叫 ComponentPerfStateCallback 例程,以在要求完成時通知驅動程式。

若要指定 ComponentPerfStateCallback 例程,請在驅動程式向 PoFx 註冊效能狀態管理時,使用 PoFxRegisterComponentPerfStates 例程的 ComponentPerfStateCallback 参數。 ComponentPerfStateCallback 例程可能適用於所有元件和所有裝置。

如果 成功 為 TRUE,驅動程式應該執行任何必要的工作,以變更硬體中的效能狀態。 如果 成功 為 FALSE,驅動程式可以選擇執行任何動作,或重試具有相同效能狀態或替代效能狀態的要求。

要求

要求 價值
最低支援的用戶端 從 Windows 10 開始支援。
目標平臺 桌面
標頭 wdm.h
IRQL 在 IRQL <= DISPATCH_LEVEL 呼叫。

另請參閱

PoFxIssueComponentPerfStateChange

PoFxIssueComponentPerfStateChangeMultiple

PoFxRegisterDevice