AcxStreamBridgeAddStream 函数 (acxstreams.h)
AcxStreamBridgeAddStream 函数将现有 ACXSTREAM 添加到现有 ACXSTREAMBRIDGE。 有关 ACX 对象的详细信息,请参阅 ACX - ACX 对象的摘要。
语法
NTSTATUS AcxStreamBridgeAddStream(
ACXSTREAMBRIDGE Bridge,
ACXSTREAM Stream
);
参数
Bridge
ACXSTREAMBRIDGE 对象由线路用于传播流创建、流的状态转换和终结点的线路流段之间的 DRM 设置。 此对象仅在多线路 (音频复合) 方案中使用。
Stream
ACXSTREAM 对象表示由线路创建的音频流。 该流由基于父线路的元素创建的元素列表组成。
返回值
STATUS_SUCCESS
如果调用成功,则返回 。 否则,它将返回相应的错误代码。 有关详细信息,请参阅 使用 NTSTATUS 值。
注解
驱动程序在以下情况下调用 AcxStreamBridgeAddStream:
() 驱动程序需要手动选择要用于当前 ACXSTREAM 的 ACXSTREAMBRIDGE。
(b) 驱动程序 (及其硬件要求) 需要下层 ACXCIRCUIT(即离设备桥引脚更近的线路)在上层 ACXCIRCUIT 执行操作之前采取措施。
(c) 驱动程序需要在下层 ACXCIRCUIT 前后执行操作。
对于 AcxStreamBridgeMux 类型,仅创建一个下层 ACXSTREAM,独立于添加到此网桥的输入 ACXSTREAM 数。 这意味着,仅为添加到 ACXSTREAMBRIDGE 的第一个 ACXSTREAM 创建输出 ACXSTREAM (对于本地线路,该输出流用 ACXTARGETSTREAM) 表示。 任何其他输入 ACXSTREAM,只需引用此现有的 ACXTARGETSTREAM 即可。
对于 AcxSTreamBridgeMux 类型,使用 AcxStreamBridgeRemoveStream 从 ACXSTREAMBRIDGE 中删除最后一个输入 ACXSTREAM 时,将删除输出 ACXTARGETSTREAM。
示例
示例用法如下所示。 未显示错误处理代码。
status = AcxStreamBridgeCreate(Circuit, &attributes, &bridgeCfg, &bridge);
// Pin ID 1 is the bridge pin in this example.
bridgePin = AcxCircuitGetPinById(Circuit, 1);
status = AcxPinAddStreamBridges(bridgePin, &bridge, 1);
status = AcxStreamBridgeAddStream(bridge, stream);
ACX 要求
最低 ACX 版本: 1.0
有关 ACX 版本的详细信息,请参阅 ACX 版本概述。
要求
要求 | 值 |
---|---|
Header | acxstreams.h |
IRQL | PASSIVE_LEVEL |