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

채널당 음성의 볼륨 수준을 설정합니다.

구문

\\HRESULT SetChannelVolumes(
  [in] UINT32      Channels,
  [in] const float *pVolumes,
  [in] UINT32      OperationSet
);

매개 변수

[in] Channels

음성의 채널 수입니다.

[in] pVolumes

음성에 있는 각 채널의 새 볼륨을 포함하는 배열입니다. 배열에는 Channels 요소가 있어야 합니다. 볼륨 수준에 대한 자세한 내용은 비고를 참조하세요.

[in] OperationSet

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

반환 값

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

설명

SetChannelVolumes 는 음성의 채널별 출력 수준을 제어하고 음성의 최종 SRC 바로 뒤와 보내기 직전에 적용됩니다.

마스터링 음성은 채널당 볼륨을 지정하지 않으므로 이 메서드는 원본 및 서브믹스 음성에만 유효합니다.

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

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

 

플랫폼 요구 사항

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

요구 사항

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

추가 정보

방법: 음성 볼륨 변경

IXAudio2Voice