通过

AcxDeviceAddCircuitDevice 函数 (acxdevice.h)

  • 项目

AcxDeviceAddCircuitDevice 函数将 ACX 线路设备添加到表示音频路径的指定父设备。

语法

NTSTATUS AcxDeviceAddCircuitDevice(
  WDFDEVICE ParentDevice,
  WDFDEVICE Device
);

参数

ParentDevice

一个 WDFDEVICE ，表示将向其添加线路设备的父级。

Device

表示要添加到父设备的线路设备的 WDFDEVICE 。

返回值

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

注解

音频驱动程序使用此函数枚举新的音频终结点。

可以在驱动程序的生命周期内随时调用此函数。 即插即用序列化与父级和同级设备上的其他即插即用活动相关的设备和关联的线路的枚举。

示例

WDFDEVICE Device;
WDFDEVICE renderDevice = NULL;
NTSTATUS  status;

// Code to initialize the WDFDEVICE...

// Code to create the WDFDEVICE renderDevice...

//
// Add circuit to device's dynamic circuit device list.
//
status = AcxDeviceAddCircuitDevice(Device, renderDevice);
if (!NT_SUCCESS(status)) 
{
    ASSERT(FALSE);
    goto exit;
}

ACX 要求

最低 ACX 版本： 1.0

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

要求

要求 值
Header acxdevice.h
IRQL PASSIVE_LEVEL

另请参阅