다음을 통해 공유


AcxCircuitAddPins 함수(acxcircuit.h)

AcxCircuitAddPins 함수는 ACXCIRCUIT에 핀을 추가합니다.

구문

NTSTATUS AcxCircuitAddPins(
  ACXCIRCUIT Circuit,
  ACXPIN     *Pins,
  ULONG      PinsCount
);

매개 변수

Circuit

기존 ACXCIRCUIT 개체입니다. ACX 개체에 대한 자세한 내용은 ACX 개체 요약을 참조하세요.

Pins

회로에 추가될 기존 ACXPIN 개체입니다.

PinsCount

회로에 추가될 핀 수입니다. 이는 하나의 기반 개수입니다.

반환 값

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

설명

ACXCIRCUIT에는 적어도 ACXPIN(입력 핀)과 ACXPIN(출력 핀)이 있으며 하나 이상의 ACXELEMENT를 집계할 수 있습니다.

각 ACXCIRCUIT에는 하나 이상의 싱크 핀과 하나의 원본 핀이 있습니다. 이러한 핀은 ACX 프레임워크에서 회로의 연결을 오디오 스택에 노출하는 데 사용됩니다. 렌더링 회로의 경우 원본 핀을 사용하여 회로에서 만든 스트림의 렌더링 동작(디바이스 속성)을 제어합니다. 캡처 회로의 경우 싱크 핀은 회로에서 생성된 모든 스트림의 캡처 동작(디바이스 속성)을 제어하는 데 사용됩니다.

ACXPIN은 오디오 경로에서 스트리밍을 제어하는 데 사용되는 개체입니다. 간단한 ACXCIRCUIT 토폴로지의 경우 ACX는 하나만 있는 경우 다른 ACXPIN을 자동으로 만들 수 있습니다.

예제

사용 예제는 다음과 같습니다.

    ACXPIN pin;  
 
    WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
    attributes.ParentObject = circuit;

    status = AcxPinCreate(circuit, &attributes, &pinCfg, &(pin[1]));
  
    // Add the supported formats to the Default mode for the circuit
    //
    formatList = AcxPinGetRawDataFormatList(pin[1]);
  
    status = AcxDataFormatListAddDataFormat(formatList, formatPcm16000c1);
  
    //
    // Add the default streaming pin, using default pin id.
    //
    status = AcxCircuitAddPins(circuit, &(pin[1]), 1);

ACX 요구 사항

최소 ACX 버전: 1.0

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

요구 사항

요구 사항
헤더 acxcircuit.h
IRQL PASSIVE_LEVEL

추가 정보