AcxDeviceRemoveCircuit 函数 (acxdevice.h)

AcxDeviceRemoveCircuit 函数从 ACX 设备中删除指定的音频线路。

语法

NTSTATUS AcxDeviceRemoveCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

参数

Device

要从中删除由 Circuit 参数指定的音频线路的 WDFDEVICE

Circuit

要从 Device 参数指定的 WDFDEVICE 中删除的音频线路。

返回值

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

注解

使用 AcxDeviceAddCircuit 将音频线路添加到 WDFDEVICE

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

示例

NTSTATUS              status;
WDFDEVICE             Device = NULL;
PUSBA2_DEVICE_CONTEXT devCtx;

// Code to initialize WDFDEVICE...

devCtx = GetDeviceContext(Device);

//
// Unregister filter and delete this audio filter.
//
if (devCtx->RenderCircuitAdded) {
    ASSERT(devCtx->RenderCircuit);
    status = AcxDeviceRemoveCircuit(Device, devCtx->RenderCircuit);

    devCtx->RenderCircuit = NULL;
    devCtx->RenderCircuitAdded = FALSE;
}

ACX 要求

最低 ACX 版本: 1.0

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

要求

要求
Header acxdevice.h
IRQL PASSIVE_LEVEL

另请参阅