EVT_ACX_FACTORY_CIRCUIT_POWER_UP回调函数 （acxcircuit.h）
驱动程序使用 EVT_ACX_FACTORY_CIRCUIT_POWER_UP 回调在 ACXFACTORYCIRCUIT 对象的上电路径中添加功能。
语法
EVT_ACX_FACTORY_CIRCUIT_POWER_UP EvtAcxFactoryCircuitPowerUp;
NTSTATUS EvtAcxFactoryCircuitPowerUp(
WDFDEVICE Device,
ACXFACTORYCIRCUIT Factory,
WDF_POWER_DEVICE_STATE PreviousState
)
{...}
参数
Device
与 ACX 线路关联的 WDFDEVICE 对象（Framework 对象摘要中所述）。
Factory
现有线路工厂 ACXFACTORYCIRCUIT 对象。 有关 ACX 对象的详细信息，请参阅 ACX 对象的摘要。
PreviousState
标识上一个设备电源状态的 WDF_POWER_DEVICE_STATE 枚举。
返回值
如果调用成功，则返回 STATUS_SUCCESS。 否则，它将返回适当的错误代码。 有关详细信息，请参阅 使用 NTSTATUS 值。
如果驱动程序失败此回调，它将 ACXFACTORYCIRCUIT 标记为 pending-delete。 ACX 框架不会使下划线 ACX EvtDeviceD0Entry 回调失败，这允许此设备中的现有工作 ACXFACTORYCIRCUIT 用于生成工作音频路径。
言论
若要注册 EvtFactoryCircuitPowerUp 回调函数，驱动程序必须调用 AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks。
如果驱动程序为设备注册了 EvtFactoryCircuitPowerUp 回调函数，则框架每次设备进入其工作状态时都会调用该函数。 发生以下情况之一时，设备将进入 D0 状态：
- 枚举设备（因为设备已插入或系统重新启动）。
- 系统及其所有设备都从低功率状态返回到其工作状态。
- 设备进入低功率状态后返回其工作状态，因为它处于空闲状态（如果设备支持低功率空闲）。
- 即插即用管理器在系统设备中重新分发了系统的硬件资源。
- 框架在设备进入工作状态（D0）状态后立即调用 EvtDeviceD0Entry 回调函数，并可供驱动程序使用，但在设备中断启用之前。 PreviousState 参数标识设备进入 D0 状态之前设备电源状态。 当框架首次调用 EvtDeviceD0Entry 时，它提供 WdfPowerDeviceD3Final 的 PreviousState 值。
此回调函数必须执行使设备完全正常运行所需的任何作。
有关提供此回调函数的驱动程序的详细信息，请参阅函数驱动程序 支持 PnP 和电源管理。
EvtFactoryCircuitPowerUp 回调函数在 IRQL = PASSIVE_LEVEL 调用。 不应使此回调函数可分页。
ACX 要求
最低 ACX 版本： 1.0
有关 ACX 版本的详细信息，请参阅 ACX 版本概述。
要求
| 要求 | 价值 |
|---|---|
| 标头 | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |