AcxDeviceRemoveCircuitDevice 函数 （acxdevice.h）

AcxDeviceRemoveCircuitDevice 函数从指定的父设备中删除 ACX 线路设备。

语法

NTSTATUS AcxDeviceRemoveCircuitDevice(
  WDFDEVICE ParentDevice,
  WDFDEVICE Device
);

参数

ParentDevice

要从中删除 ACX 线路设备的父 WDFDEVICE。

Device

WDFDEVICE 表示要从父设备中删除的线路设备。

返回值

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

言论

音频驱动程序使用此函数删除现有音频终结点。

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

例

NTSTATUS status;
WDFDEVICE Device;
WDFDEVICE child;

// Code to initialize WDFDEVICE objects...

// Remove the child device.
status = AcxDeviceRemoveCircuitDevice(Device, child);

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

ACX 要求

最低 ACX 版本： 1.0

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

要求

另请参阅

• AcxDeviceRemoveCircuit
• acxdevice.h 标头