通过

AcxCircuitAddPins 函数 (acxcircuit.h)

  • 项目

AcxCircuitAddPins 函数将引脚添加到 ACXCIRCUIT。

语法

NTSTATUS AcxCircuitAddPins(
  ACXCIRCUIT Circuit,
  ACXPIN     *Pins,
  ULONG      PinsCount
);

参数

Circuit

现有的 ACXCIRCUIT 对象。 有关 ACX 对象的详细信息，请参阅 ACX 对象的摘要。

Pins

将添加到线路的现有 ACXPIN 对象。

PinsCount

将添加到线路的引脚数。 这是一个基于 1 的计数。

返回值

STATUS_SUCCESS如果调用成功，则返回 。 否则，它将返回相应的错误代码。 有关详细信息，请参阅 使用 NTSTATUS 值。

注解

ACXCIRCUIT 至少有一个输入引脚 (ACXPIN) 和一个输出引脚 (ACXPIN) ，它可以聚合一个或多个 ACXELEMENT。

每个 ACXCIRCUIT 至少有一个接收器引脚和一个源引脚。 ACX 框架使用这些引脚来公开线路与音频堆栈的连接。 对于呈现线路，源引脚用于控制从线路创建的任何流的呈现行为 (设备属性) 。 对于捕获线路，接收器引脚用于控制从线路创建的任何流的捕获行为 (设备属性) 。

ACXPIN 是用于控制音频路径中的流式处理的对象。 对于简单的 ACXCIRCUIT 拓扑，如果只有一个 ACXPIN 存在，ACX 能够自动创建另一个 ACXPIN。

示例

示例用法如下所示。

    ACXPIN pin;  
 
    WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
    attributes.ParentObject = circuit;

    status = AcxPinCreate(circuit, &attributes, &pinCfg, &(pin[1]));
  
    // Add the supported formats to the Default mode for the circuit
    //
    formatList = AcxPinGetRawDataFormatList(pin[1]);
  
    status = AcxDataFormatListAddDataFormat(formatList, formatPcm16000c1);
  
    //
    // Add the default streaming pin, using default pin id.
    //
    status = AcxCircuitAddPins(circuit, &(pin[1]), 1);

ACX 要求

最低 ACX 版本： 1.0

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

要求

要求 值
Header acxcircuit.h
IRQL PASSIVE_LEVEL

另请参阅