IMFSimpleAudioVolume::SetMasterVolume 메서드(mfidl.h)

  • 아티클

master 볼륨 수준을 설정합니다.

구문

HRESULT SetMasterVolume(
  [in] float fLevel
);

매개 변수

[in] fLevel

볼륨 수준입니다. 볼륨은 감쇠 수준으로 표현됩니다. 여기서 0.0은 무음, 1.0은 전체 볼륨(감쇠 없음)을 나타냅니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드 Description
S_OK
 메서드가 성공했습니다.
MF_E_NOT_INITIALIZED
 오디오 렌더러가 초기화되지 않았습니다.
MF_E_STREAMSINK_REMOVED
 오디오 렌더러가 파이프라인에서 제거되었습니다.

설명

애플리케이션 외부의 이벤트는 master 볼륨 수준을 변경할 수 있습니다. 예를 들어 사용자는 SndVol(시스템 볼륨 제어 프로그램)에서 볼륨을 변경할 수 있습니다. 외부 이벤트가 master 볼륨을 변경하는 경우 오디오 렌더러는 미디어 세션이 애플리케이션에 전달하는 MEAudioSessionVolumeChanged 이벤트를 보냅니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 mfidl.h
라이브러리 Mfuuid.lib

참고 항목

IMFSimpleAudioVolume

스트리밍 오디오 렌더러