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
WDFDEVICE 对象(Framework 对象的摘要中所述),它是设备对象中引用的 WDFDEVICE 的父对象。
Factory
现有线路工厂 ACXFACTORYCIRCUIT 对象。 有关 ACX 对象的详细信息,请参阅 ACX 对象的摘要。
Device
必须删除的 WDFDEVICE 对象(Framework 对象的摘要中所述)。
返回值
如果调用成功,则返回 STATUS_SUCCESS
。 否则,它将返回适当的错误代码。 有关详细信息,请参阅 使用 NTSTATUS 值。
言论
AcxFactoryCircuit 表示能够按需创建 ACXCIRCUIT 的工厂对象。
驱动程序可以将一个或多个 ACXFACTORYCIRCUIT 注册到 ACX,此作将让 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 版本概述。
要求
要求 | 价值 |
---|---|
标头 | acxcircuit.h |
IRQL | PASSIVE_LEVEL |