通过

AcxDeviceAddFactoryCircuit 函数 (acxdevice.h)

  • 项目

AcxDeviceAddFactoryCircuit 函数将工厂线路添加到 WDFDEVICE，用于创建音频线路。

语法

NTSTATUS AcxDeviceAddFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

参数

Device

将向其添加 ACX 工厂线路的 WDFDEVICE 。

Factory

要添加到 Device 参数指定的 WDFDEVICE 的 ACX 工厂线路。

返回值

如果调用成功，AcxDeviceAddFactoryCircuit 将返回STATUS_SUCCESS。 否则，它将返回 NTSTATUS 错误代码。

注解

在以下情况下，ACX 驱动程序可能会创建一个或多个线路：

  • 初始化时
  • 在运行时，作为外部事件的副作用，例如检测新的音频组件
  • 因为它将自己注册到 ACX 作为线路工厂。 ACX 框架使用已注册的工厂要求驱动程序创建新线路。

使用 AcxDeviceRemoveFactoryCircuit 从 WDFDEVICE 中删除工厂线路。

只能从此设备的 EVT_WDF_DEVICE_PREPARE_HARDWARE 回调函数调用此函数。

示例

WDFDEVICE                Device;
NTSTATUS                 status;
PCAPTURE_DEVICE_CONTEXT  devCtx;

// Code to initialize WDFDEVICE...

//
// Add control circuit to child's list.
//
status = AcxDeviceAddFactoryCircuit(Device, devCtx->CtrlCircuit);

if (!NT_SUCCESS(status))
{
    ASSERT(FALSE);
    goto exit;
}

ACX 要求

最低 ACX 版本： 1.0

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

要求

要求 值
Header acxdevice.h
IRQL PASSIVE_LEVEL

另请参阅