다음을 통해 공유


ISpatialAudioObject::SetVolume 메서드(spatialaudioclient.h)

오디오 렌더링 엔진에 제출되기 전에 ISpatialAudioObject 에서 제공하는 오디오 데이터에 적용되는 오디오 진폭 승수를 설정합니다.

구문

HRESULT SetVolume(
  [in] float volume
);

매개 변수

[in] volume

오디오 데이터의 진폭 승수입니다. 0.0에서 1.0 사이의 값이어야 합니다.

반환 값

메서드가 성공하면 S_OK가 반환되고, 실패할 경우 가능한 반환 코드는 다음 표에 표시된 값을 포함하지만 이에 국한되지 않습니다.

반환 코드 설명
SPTLAUDCLNT_E_OUT_OF_ORDER

SetVolume을 호출하기 전에 ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects가 호출되지 않았습니다.

SPTLAUDCLNT_E_RESOURCES_INVALIDATED

SetEndOfStream 은 이전 오디오 처리 단계에서 명시적으로 또는 암시적으로 호출되었습니다. GetBuffer가 오디오 처리 패스 내에서 호출되지 않는 경우 시스템에서 SetEndOfStream을 암시적으로 호출합니다(ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjectsISpatialAudioObjectRenderStreamBase::EndUpdatingAudioObjects 호출 사이).

설명

SetVolume이 호출되지 않으면 기본값 1.0이 사용됩니다. SetVolume이 호출되면 SetVolume에 대한 다른 호출로 볼륨이 변경될 때까지 설정된 볼륨이 오디오 개체에 사용됩니다.

요구 사항

   
대상 플랫폼 Windows
헤더 spatialaudioclient.h

추가 정보

ISpatialAudioObject