EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE回调函数 (acxcircuit.h)

当驱动程序必须删除以前创建的与 ACXCIRCUIT 对象关联的 WDFDEVICE 时，ACX 将调用 EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE 回调。

语法

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE EvtAcxFactoryCircuitDeleteCircuitdevice;

NTSTATUS EvtAcxFactoryCircuitDeleteCircuitdevice(
  WDFDEVICE Parent,
  ACXFACTORYCIRCUIT Factory,
  WDFDEVICE Device
)
{...}

参数

Parent

作为 Device (对象中引用的 WDFDEVICE 的父级的 框架对象) 摘要 中所述的 WDFDEVICE 对象。

Factory

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

Device

必须删除的 框架对象) 摘要中所述的 WDFDEVICE 对象 (。

返回值

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

注解

AcxFactoryCircuit 表示能够按需创建 ACXCIRCUIT 的工厂对象。

驱动程序可以向 ACX 注册一个或多个 ACXFACTORYCIRCUIT，此操作将使 ACX 知道驱动程序能够创建定义良好的类型的 ACXCIRCUIT。

ACX 在检测到音频路径需要工厂提供的 ACXCIRCUIT 之一时调用 ACXFACTORYCIRCUIT 的回调。

这是一个可选回调，如果未定义EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE回调，ACX 会执行默认操作，即从枚举设备列表中删除指定的 WDFDEVICE。 此操作会向子 WDFDEVICE 触发意外删除的 PnP 通知。

ACXFACTORYCIRCUIT 对象支持动态 ACXCIRCUIT，这意味着工厂创建的每个 ACXCIRCUIT 都与 WDFDEVICE 相关联，并且这两个对象具有相同的生存期。

AcxFactoryCircuit 具有专用的 WDF 队列。 有关 WDF 队列的详细信息，请参阅 框架队列对象。

ACX 要求

最低 ACX 版本： 1.0

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

要求

要求	值
Header	acxcircuit.h
IRQL	PASSIVE_LEVEL

另请参阅

• acxcircuit.h 标头