AcxStreamAudioEngineCreate 함수(acxelements.h)

  • 아티클

AcxStreamAudioEngineCreate 함수는 ACX 스트림 개체 부모에 연결될 ACX 스트림 오디오 엔진 개체를 만드는 데 사용됩니다. ACX 개체에 대한 자세한 내용은 ACX 개체 요약을 참조하세요.

구문

NTSTATUS AcxStreamAudioEngineCreate(
  ACXSTREAM                     Stream,
  ACXAUDIOENGINE                AudioEngine,
  PWDF_OBJECT_ATTRIBUTES        Attributes,
  PACX_STREAMAUDIOENGINE_CONFIG Config,
  ACXSTREAMAUDIOENGINE          *StreamAudioEngine
);

매개 변수

Stream

특정 회로 하드웨어의 오디오 스트림을 나타내는 ACXSTREAM 개체입니다. ACX 개체에 대한 자세한 내용은 ACX 개체 요약을 참조하세요.

AudioEngine

DSP를 나타내기 위해 렌더링 회로에 사용되는 ACXAUDIOENGINE 개체입니다. ACX 개체에 대한 자세한 내용은 ACX 개체 요약을 참조하세요.

Attributes

다양한 값을 설정하고 스트림 오디오 엔진을 부모 스트림 개체와 연결하는 데 사용되는 WDF_OBJECT_ATTRIBUTES 구조를 사용하여 정의된 추가 특성입니다.

Config

스트림 오디오 엔진의 구성을 설명하는 초기화된 ACX_STREAMAUDIOENGINE_CONFIG 구조 체입니다.

StreamAudioEngine

새로 만든 ACXSTREAMAUDIOENGINE 개체에 대한 핸들을 수신하는 위치에 대한 포인터입니다. ACX 개체에 대한 자세한 내용은 ACX 개체 요약을 참조하세요.

반환 값

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

설명

예제

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

    NTSTATUS                        status;
    WDF_OBJECT_ATTRIBUTES           attributes;
    ACXSTREAM                       stream;
    ACXELEMENT                      elements[2] = {0};
    ACX_STREAMAUDIOENGINE_CONFIG    audioEngineCfg;

        ACX_STREAMAUDIOENGINE_CONFIG_INIT(&audioEngineCfg);
        audioEngineCfg.VolumeElement = volumeElement;
        audioEngineCfg.MuteElement = muteElement;
        audioEngineCfg.PeakMeterElement = peakmeterElement;
        audioEngineCfg.Callbacks = &streamAudioEngineCallbacks;

        WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_STREAMAUDIOENGINE_CONTEXT);
        attributes.ParentObject = stream;

        status = AcxStreamAudioEngineCreate(stream, circuitCtx->AudioEngineElement, &attributes, &audioEngineCfg, (ACXSTREAMAUDIOENGINE*)&elements[0]);

ACX 요구 사항

최소 ACX 버전: 1.0

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

요구 사항

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

추가 정보