AcxStreamBridgeCreate 함수(acxstreams.h)

아티클
02/26/2024

AcxStreamBridgeCreate 함수는 ACX_STREAM_BRIDGE_CONFIG 사용하여 회로에 대한 StreamBridge를 만듭니다.

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

구문

NTSTATUS AcxStreamBridgeCreate(
  ACXCIRCUIT                AcxCircuit,
  PWDF_OBJECT_ATTRIBUTES    Attributes,
  PACX_STREAM_BRIDGE_CONFIG Config,
  ACXSTREAMBRIDGE           *StreamBridge
);

매개 변수

AcxCircuit

연결된 ACXCIRCUIT 개체에 대한 핸들을 수신하는 위치에 대한 포인터입니다. ACX 개체에 대한 자세한 내용은 ACX - ACX 개체 요약을 참조하세요.

Attributes

다양한 개체의 값을 설정하는 데 사용되는 WDF_OBJECT_ATTRIBUTES 사용하여 정의된 추가 특성: 콜백 정리 및 제거, 컨텍스트 형식, 부모 개체 지정 자세한 내용은 WDF_OBJECT_ATTRIBUTES 구조 및 이 항목의 설명 섹션을 참조하세요.

Config

구성을 정의하는 ACX_STREAM_BRIDGE_CONFIG 구조체입니다.

StreamBridge

새 ACXSTREAMBRIDGE 개체에 대한 핸들을 수신하는 위치에 대한 포인터입니다.

반환 값

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

설명

오디오 엔드포인트는 전체 오디오 경로를 만들기 위해 어셈블되는 하나 이상의 오디오 회로(ACXCIRCUIT 개체)의 컬렉션입니다. ACX 드라이버는 일반적으로 다른 오디오 엔드포인트에 대한 오디오 회로를 만듭니다. ACX는 동일한 드라이버에서 만든 회로가 다른 디바이스 스택에 속하는 한 동일한 오디오 엔드포인트 컬렉션의 일부가 되는 것을 금지하지는 않습니다. 오디오 엔드포인트는 동일하거나 다른 오디오 드라이버에서 만든 오디오 회로의 컬렉션입니다.

기본적으로 새 ACXSTREAMBRIDGE 개체의 부모는 지정된 ACXCIRCUIT입니다. WDF_OBJECT_ATTRIBUTES 구조체의 ParentObject 멤버를 사용하여 ACXCIRCUIT를 상위 항목으로 사용하여 다른 부모를 지정할 수 있습니다. 프레임워크는 부모 개체를 삭제할 때 ACXSTREAMBRIDGE 개체를 삭제합니다.

드라이버는 개체 사용을 완료하면 ACXSTREAMBRIDGE 개체를 삭제할 수 있습니다. 그렇지 않으면 부모가 삭제될 때까지 개체가 유지됩니다. 이 경우 ACXCIRCUIT 초기화/생성 중에 개체가 만들어집니다.

핀은 0개, 하나 이상의 ACXSTREAMBRIDGE와 연결할 수 있습니다. ACX는 연결된 ACXPIN의 신호 처리 모드 목록에서 스트림 신호 처리 모드 일치를 검색합니다. 검색은 첫 번째 일치 항목에서 중지됩니다.

ACX는 드라이버가 하나를 만들지 않는 경우 ACXCIRCUIT에 ACXCIRCUIT에 대한 기본 ACXSTREAMBRIDGE를 만들고, 드라이버는 AcxCircuitInitDisableDefaultStreamBridgeHandling 함수를 사용하여 기본 스트림 브리지 처리를 사용하지 않도록 설정하지 않았습니다.

예제

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

    ACX_STREAM_BRIDGE_CONFIG bridgeCfg;
    ACXSTREAMBRIDGE          bridge = NULL;
    
    ACX_STREAM_BRIDGE_CONFIG_INIT(&bridgeCfg);
    bridgeCfg.InModesCount = 1;
    bridgeCfg.InModes      = inModes; 
    bridgeCfg.OutMode      = &AUDIO_SIGNALPROCESSINGMODE_DEFAULT;

    status = AcxStreamBridgeCreate(circuit, &attributes, &bridgeCfg, &bridge);

ACX 요구 사항

최소 ACX 버전: 1.0

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

요구 사항

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

추가 정보

acxstreams.h 헤더