PO_FX_COMPONENT_PERF_STATE_CALLBACK回调函数 (wdm.h)

项目
03/05/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 或 PoFxIssueComponentPerfStateChangeMultiple 例程的 Context 参数指定的可选驱动程序或设备上下文的指针。

返回值

无

备注

当设备驱动程序通过调用 PoFxIssueComponentPerfStateChange 或 PoFxIssueComponentPerfStateChangeMultiple 例程请求性能状态更改时，PoFx 会调用 ComponentPerfStateCallback 例程，以便在请求完成时通知驱动程序。

若要指定 ComponentPerfStateCallback 例程，请在驱动程序注册 PoFx 的性能状态管理时，使用 PoFxRegisterComponentPerfStates 例程的 ComponentPerfStateCallback 参数。对于所有组件和所有设备， ComponentPerfStateCallback 例程可能相同。

如果 Succeeded 为 TRUE，则驱动程序应执行更改硬件中性能状态所需的任何工作。如果 Succeeded 为 FALSE，则驱动程序可以选择不执行任何操作，或者重试具有相同性能状态或备用性能状态的请求。