AcxDeviceAddCircuit 函数 (acxdevice.h)

  • 项目

AcxDeviceAddCircuit 函数将 ACX 线路添加到 WDFDEVICE 以创建音频终结点。

语法

NTSTATUS AcxDeviceAddCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

参数

Device

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

Circuit

要添加到 设备的线路。

返回值

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

注解

音频线路是 ACX 的核心构建基块。 音频驱动程序创建一个或多个 ACX 线路对象来表示部分或完整的音频数据和控制路径。 ACX 将这些 ACX 线路对象组合在一起，以创建表示音频终结点的完整音频路径。

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

示例

WDFDEVICE             Device;
NTSTATUS              status;
PCODEC_DEVICE_CONTEXT devCtx;

// Code to initialize the WDFDEVICE...

devCtx = GetCodecDeviceContext(Device);
ASSERT(devCtx != NULL);

//
// Add static circuit to device's list.
//
ASSERT(devCtx->Render);
status = AcxDeviceAddCircuit(Device, devCtx->Render);

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

ACX 要求

最低 ACX 版本： 1.0

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

要求

要求 值
Header acxdevice.h
IRQL PASSIVE_LEVEL

另请参阅