通过

AcxDeviceAddFactoryCircuit 函数 （acxdevice.h）

  • 项目

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

语法

NTSTATUS AcxDeviceAddFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

参数

Device

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

Factory

要添加到 设备 参数指定的 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 版本概述。

要求

要求 价值
标头 acxdevice.h
IRQL PASSIVE_LEVEL

另请参阅