AcxStreamBridgeAddStream 함수(acxstreams.h)

아티클
10/28/2023

AcxStreamBridgeAddStream 함수는 기존 ACXSTREAMBRIDGE에 기존 ACXSTREAM을 추가합니다. ACX 개체에 대한 자세한 내용은 ACX - ACX 개체 요약을 참조하세요.

구문

NTSTATUS AcxStreamBridgeAddStream(
  ACXSTREAMBRIDGE Bridge,
  ACXSTREAM       Stream
);

매개 변수

Bridge

ACXSTREAMBRIDGE 개체는 회로에서 스트림 생성, 스트림의 상태 전환 및 엔드포인트의 회로 스트림 세그먼트 간의 DRM 설정을 전파하는 데 사용됩니다. 이 개체는 다중 회로(오디오 복합) 시나리오에서만 사용됩니다.

Stream

ACXSTREAM 개체는 회로에서 만든 오디오 스트림을 나타냅니다. 스트림은 부모 회로의 요소를 기반으로 만든 요소 목록으로 구성됩니다.

반환 값

호출이 성공하면 를 반환합니다 STATUS_SUCCESS . 그렇지 않으면 적절한 오류 코드를 반환합니다. 자세한 내용은 NTSTATUS 값 사용을 참조하세요.

설명

드라이버는 다음 시나리오에서 AcxStreamBridgeAddStream을 호출합니다.

(a) 드라이버는 현재 ACXSTREAM에 사용할 ACXSTREAMBRIDGE를 수동으로 선택하려고 합니다.

(b) 드라이버(및 해당 하드웨어 요구 사항)에는 하위 ACXCIRCUIT( 즉, 디바이스 브리지 핀에 가까운 회로)가 상위 수준 ACXCIRCUIT가 조치를 취하기 전에 조치를 취해야 합니다.

AcxStreamBridgeMux 형식의 경우 이 브리지에 추가된 입력 ACXSTREAM 수와 독립적으로 하나의 하위 ACXSTREAM만 생성됩니다. 즉, 출력 ACXSTREAM(로컬 회로의 경우 스트림이 ACXTARGETSTREAM으로 표현됨)은 ACXSTREAMBRIDGE에 추가된 첫 번째 ACXSTREAM에 대해서만 만들어집니다. 추가 입력 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 버전 개요를 참조하세요.

요구 사항

요구 사항	값
헤더	acxstreams.h
IRQL	PASSIVE_LEVEL

추가 정보

acxstreams.h 헤더