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 对象 (。

Factory

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

PreviousState

标识上一个设备电源状态 的WDF_POWER_DEVICE_STATE枚举 。

返回值

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

如果驱动程序失败此回调，它会将 ACXFACTORYCIRCUIT 标记为 pending-delete。 ACX 框架不会使下划线 ACX EvtDeviceD0Entry 回调失败，这允许使用此设备的现有工作 ACXFACTORYCIRCUIT 来生成正常工作的音频路径。

注解

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

如果驱动程序为设备注册了 EvtFactoryCircuitPowerUp 回调函数，则每次设备进入其工作 (D0) 状态时，框架都会调用该函数。 发生以下情况之一时，设备将进入 D0 状态：

• (枚举设备，因为设备已接通电源或系统在) 重新启动。
• 系统及其所有设备从低功耗状态返回到其工作状态。
• 设备在进入低功耗状态后返回到其工作状态，因为它处于空闲状态 (如果设备支持低功率空闲) 。
• 即插即用管理器已在系统设备之间重新分发了系统的硬件资源。
• 框架在设备进入其工作 (D0) 状态后立即调用 EvtDeviceD0Entry 回调函数，并可供驱动程序使用，但在启用设备的中断之前。 PreviousState 参数标识设备进入 D0 状态之前处于的设备电源状态。 当框架首次调用 EvtDeviceD0Entry 时，它提供 WdfPowerDeviceD3Final 的 PreviousState 值。

此回调函数必须执行使设备完全正常运行所需的任何操作。

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

EvtFactoryCircuitPowerUp 回调函数在 IRQL = PASSIVE_LEVEL 调用。 不应使此回调函数可分页。

ACX 要求

最低 ACX 版本： 1.0

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

要求

另请参阅

• acxcircuit.h 标头