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 |