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

另请参阅