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 结构中的索引。 如果 组件 数组包含 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