Функция AcxStreamBridgeAddStream (acxstreams.h)

Статья
02/06/2025

Функция AcxStreamBridgeAddStream добавляет существующий ACXSTREAM в существующий ACXSTREAMBRIDGE. Дополнительные сведения о объектах ACX см. в ACX — сводка по объектам ACX.

Синтаксис

NTSTATUS AcxStreamBridgeAddStream(
  ACXSTREAMBRIDGE Bridge,
  ACXSTREAM       Stream
);

Параметры

Bridge

Объект ACXSTREAMBRIDGE используется каналом для распространения создания потока, перехода состояний потока и параметров DRM между сегментами потока конечной точки. Этот объект используется только в сценарии с несколькими каналами (составной звук).

Stream

Объект ACXSTREAM представляет звуковой поток, созданный каналом. Поток состоит из списка элементов, созданных на основе элементов родительского канала.

Возвращаемое значение

Возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в использовании значений NTSTATUS.

Замечания

Драйверы вызывают AcxStreamBridgeAddStream в следующих сценариях:

(a) драйверы хотят вручную выбрать ACXSTREAMBRIDGE, который будет использоваться для текущего ACXSTREAM.

(b) драйверы (и их требования к оборудованию) имеют потребность в нижнем уровне ACXCIRCUITs, т. е. цепи ближе к закреплению моста устройства, чтобы принять меры перед принятием мер до принятия мер на верхнем уровне ACXCIRCUITs.

Для типа AcxStreamBridgeMux создается только один нисходящий ACXSTREAM независимо от количества входных ACXSTREAMs, добавленных в этот мост. Это означает, что выходной ACXSTREAM (который для локального канала представлен потоком с ACXTARGETSTREAM), создается только для первого добавленного в ACXSTREAMBRIDGE. Любые дополнительные входные данные ACXSTREAMs, просто возьмите ссылку на этот существующий ACXTARGETSTREAM.

Для типа AcxSTreamBridgeMux выходные данные ACXTARGETSTREAM удаляются при удалении последнего входного ACXSTREAM из ACXSTREAMBRIDGE с AcxStreamBridgeRemoveStream.

Пример

Ниже показан пример использования. Код обработки ошибок не отображается.

        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.

Требования

Требование	Ценность
заголовка	acxstreams.h
IRQL	PASSIVE_LEVEL

См. также

заголовка acxstreams.h

Поделиться через