IXAudio2Voice::SetVolume 메서드(xaudio2.h)

음성의 전체 볼륨 수준을 설정합니다.

구문

\\HRESULT SetVolume(
  [in] float  Volume,
  [in] UINT32 OperationSet
);

매개 변수

[in] Volume

사용할 전체 볼륨 수준입니다. 볼륨 수준에 대한 자세한 내용은 비고를 참조하세요.

[in] OperationSet

이 호출을 지연된 일괄 처리의 일부로 식별합니다. 자세한 내용은 XAudio2 작업 집합 개요를 참조하세요.

반환 값

성공하면 S_OK 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드에 대한 설명은 XAudio2 오류 코드를 참조하세요.

설명

SetVolume은 음성의 master 입력 볼륨 수준을 제어합니다. master 볼륨 수준은 음성 유형에 따라 서로 다른 시간에 적용됩니다. 서브믹스 및 마스터링 음성의 경우 볼륨 수준은 음성의 기본 제공 필터 및 효과 체인이 적용되기 직전에 적용됩니다. 원본 음성의 경우 음성의 필터 및 효과 체인이 적용된 후 master 볼륨 수준이 적용됩니다.

볼륨 수준은 -XAUDIO2_MAX_VOLUME_LEVEL 및 XAUDIO2_MAX_VOLUME_LEVEL(-2²에서 2²) 사이의 부동 소수점 진폭 승수로 표현되며 최대 게인은 144.5dB입니다. 볼륨 수준이 1.0이면 감쇠 또는 게인이 없고 0은 침묵을 의미합니다. 음수 수준은 오디오의 위상을 반전하는 데 사용할 수 있습니다. 볼륨 제어에 대한 자세한 내용은 XAudio2 볼륨 및 피치 컨트롤을 참조하세요.

참고IXAudio2Voice::GetVolume 은 항상 IXAudio2Voice::SetVolume에서 가장 최근에 설정한 볼륨을 반환합니다. 그러나 실제로는 적용되지 않을 수 있습니다. 오디오 엔진이 다음에 IXAudio2Voice::SetVolume 호출 후에 실행될 때만 적용됩니다(또는 해당 IXAudio2::CommitChanges 호출 후 IXAudio2Voice::SetVolume 이 지연된 작업 ID로 호출된 경우).

 

플랫폼 요구 사항

Windows 10(XAudio2.9); Windows 8, Windows Phone 8(XAudio 2.8); DirectX SDK(XAudio 2.7)

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	xaudio2.h

추가 정보

방법: 음성 볼륨 변경

방법: 서브믹스 음성 사용

IXAudio2Voice