PO_FX_COMPONENT_PERF_STATE_CALLBACK回呼函式 (wdm.h)

發行項
03/01/2024

ComponentPerfStateCallback 回呼例程會通知驅動程式其變更元件的效能狀態的要求已完成。

語法

PO_FX_COMPONENT_PERF_STATE_CALLBACK PoFxComponentPerfStateCallback;

void PoFxComponentPerfStateCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Succeeded,
  [in] PVOID RequestContext
)
{...}

參數

[in] Context

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

[in] Component

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

[in] Succeeded

如果為TRUE，則平臺擴充功能外掛程式 (PEP) 成功效能狀態變更。如果為 FALSE，PEP 會失敗效能狀態變更。如需詳細資訊，請參閱＜備註＞一節。

[in] RequestContext

由 PoFxIssueComponentPerfStateChange 或 PoFxIssueComponentPerfStateChange 或 PoFxIssueComponentPerfStateChangeMultiple 例程所指定的選擇性驅動程式或裝置內容的指標。

傳回值

無

備註

當設備驅動器藉由呼叫 PoFxIssueComponentPerfStateChange 或 PoFxIssueComponentPerfStateChangeMultiple 例程來要求效能狀態變更時，PoFx 會呼叫 ComponentPerfStateCallback 例程，以在要求完成時通知驅動程式。

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

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