AcxStreamBridgeRemoveStream 함수(acxstreams.h)

아티클
04/30/2024

AcxStreamBridgeRemoveStream 함수는 ACXSTREAMBRIDGE 개체 에서 지정된 ACXSTREAM을 제거합니다. ACX 개체에 대한 자세한 내용은 ACX - ACX 개체 요약을 참조하세요.

구문

NTSTATUS AcxStreamBridgeRemoveStream(
  ACXSTREAMBRIDGE Bridge,
  ACXSTREAM       Stream
);

매개 변수

Bridge

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

Stream

ACXSTREAMBRIDGE에서 제거할 ACXSTREAM 개체에 대한 핸들입니다.

반환 값

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

설명

이 DDI는 드라이버의 스트림 정리 처리기 컨텍스트에서만 호출할 수 있습니다. 호출자는 이 DDI를 호출하여 지정된 ACXSTREAMBRIDGE 개체에서 입력 ACXSTREAM을 수동으로 분리합니다.

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

(a) 드라이버는 ACXSTREAMBRIDGE에서 ACXSTREAM을 수동으로 제거하려고 합니다.

(b) 드라이버(및 h/w 요구 사항)는 상위 수준 ACXSTREAM, 즉 회로가 스트리밍 브리지 핀에 더 가깝게 스트림되어 하위 수준 ACXSTREAM 전에 조치를 취해야 합니다.

AcxStreamBridgeMux 형식의 경우 이 브리지에 추가된 입력 ACXSTREAM 수와 독립적으로 하위 수준 ACXSTREAM이 하나만 만들어집니다. 즉, 출력 ACXSTREAM(로컬 회로의 경우 스트림이 ACXTARGETSTREAM으로 표현됨)은 ACXSTREAMBRIDGE에 추가된 첫 번째 ACXSTREAM에 대해서만 생성됩니다. 추가 입력 ACXSTREAM은 이 기존 ACXTARGETSTREAM을 참조하기만 하면 됩니다.

AcxStreamBridgeMux 형식의 경우 AcxStreamBridgeRemoveStream을 사용하여 ACXSTREAMBRIDGE에서 마지막 입력 ACXSTREAM이 제거되면 출력 ACXTARGETSTREAM이 제거됩니다.

예제

예제 사용법은 다음과 같습니다.

    status = AcxStreamBridgeAddStream(bridge, stream);

    // Get I/O target to send I/O to the target stream.
    targetStream = AcxStreamBridgeGetTargetStream(bridge, stream);
 
    // Target stream is closed if this was last input ACXSTREAM removed.
    status = AcxStreamBridgeRemoveStream(bridge, stream);

ACX 요구 사항

최소 ACX 버전: 1.0

ACX 버전에 대한 자세한 내용은 ACX 버전 개요를 참조하세요.

요구 사항

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

추가 정보

acxstreams.h 헤더