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 版本概述。

要求

要求 值
Header acxdevice.h
IRQL PASSIVE_LEVEL

另请参阅