EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN回调函数 (acxcircuit.h)

驱动程序使用EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN回调在 ACXFACTORYCIRCUIT 对象的电源关闭路径中添加功能。

语法

EVT_ACX_FACTORY_CIRCUIT_POWER_DOWN EvtAcxFactoryCircuitPowerDown;

NTSTATUS EvtAcxFactoryCircuitPowerDown(
  WDFDEVICE Device,
  ACXFACTORYCIRCUIT Factory,
  WDF_POWER_DEVICE_STATE TargetState
)
{...}

参数

Device

与 ACX 线路关联的 框架对象) 摘要 中所述的 WDFDEVICE 对象 (。

Factory

现有线路工厂 ACXFACTORYCIRCUIT 对象。 有关 ACX 对象的详细信息，请参阅 ACX 对象的摘要。

TargetState

标识目标设备电源状态 的WDF_POWER_DEVICE_STATE枚举 。

返回值

STATUS_SUCCESS如果调用成功，则返回 。 否则，它将返回相应的错误代码。 有关详细信息，请参阅 使用 NTSTATUS 值。

注解

若要注册 EvtAcxFactoryCircuitPrepareHardware 回调函数，驱动程序必须调用 AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks。

如果驱动程序已注册 EvtCircuitPowerDown 回调函数，则每次驱动程序的某个设备离开其工作 (D0) 状态时，ACX 框架都会调用该函数。 发生以下情况之一时，设备将保持 D0 状态：

• 系统及其所有设备即将离开其工作状态并进入低功耗状态。
• 如果设备支持低功耗空闲，则设备即将进入低功耗状态，因为它处于空闲状态。
• 即插即用管理器正在尝试重新分发系统的硬件资源。
• 用户通常通过应用程序的用户界面指示他/她要删除设备。
• 在意外删除设备后，框架还会调用 EvtFactoryCircuitPowerDown 回调函数 (意外删除) 。

有关框架何时调用此回调函数的详细信息，请参阅 PnP 和电源管理方案。

除非设备被意外移除，否则 ACX 框架会在禁用设备的中断之后、在设备电源从 D0 降低之前以及 WDF 在关联设备上调用驱动程序的 EvtDeviceD0Exit 回调之前立即调用此回调函数。 TargetState 参数标识设备即将进入的设备电源状态。

EvtFactoryCircuitPowerDown 回调函数必须在 ACXFACTORYCIRCUT 的硬件进入指定的低功耗状态之前执行任何必要的操作，例如保存驱动程序稍后将 ACXFACTORYCIRCUIT 的硬件还原到其 D0 电源状态所需的任何信息。

如果 TargetState 为 WdfPowerDeviceD3Final，则应假定系统已关闭、关联的设备即将被删除，或者正在进行资源再平衡。 如果驱动程序必须保存信息，则应将其写入磁盘或其他永久性存储介质。

有关提供此回调函数的驱动程序的详细信息，请参阅 在函数驱动程序中支持 PnP 和电源管理。

ACX 要求

最低 ACX 版本： 1.0

有关 ACX 版本的详细信息，请参阅 ACX 版本概述。

要求

要求	值
Header	acxcircuit.h
IRQL	PASSIVE_LEVEL

另请参阅

• acxcircuit.h 标头