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 |