IAudioSessionEvents::OnSimpleVolumeChanged 메서드(audiopolicy.h)

OnSimpleVolumeChanged 메서드는 오디오 세션의 볼륨 수준 또는 음소거 상태가 변경되었음을 클라이언트에 알릴 수 있습니다.

구문

HRESULT OnSimpleVolumeChanged(
  [in] float   NewVolume,
  [in] BOOL    NewMute,
  [in] LPCGUID EventContext
);

매개 변수

[in] NewVolume

오디오 세션의 새 볼륨 수준입니다. 이 매개 변수는 0.0에서 1.0 범위의 값입니다. 여기서 0.0은 무음이고 1.0은 전체 볼륨(감쇠 없음)입니다.

[in] NewMute

새 음소거 상태입니다. TRUE이면 음소거가 사용됩니다. FALSE이면 음소거를 사용할 수 없습니다.

[in] EventContext

이벤트 컨텍스트 값입니다. 이는 호출자가 세션의 볼륨 수준 또는 음소거 상태를 변경한 호출에서 ISimpleAudioVolume::SetMasterVolume 또는 ISimpleAudioVolume::SetMute 에 전달한 값과 동일합니다. 자세한 내용은 설명 부분을 참조하세요.

반환 값

메서드가 성공하면 S_OK가 반환되고, 그렇지 않으면 오류 코드가 반환됩니다.

설명

세션 관리자는 ISimpleAudioVolume::SetMasterVolume 또는 ISimpleAudioVolume::SetMute 메서드에 대한 호출이 세션의 볼륨 수준 또는 음소거 상태를 변경할 때마다 이 메서드를 호출합니다.

EventContext 매개 변수는 클라이언트가 시작한 볼륨 또는 음소거 변경과 다른 클라이언트가 시작한 변경 사항을 구분하는 수단을 제공합니다. ISimpleAudioVolume::SetMasterVolume 또는 ISimpleAudioVolume::SetMute 메서드를 호출할 때 클라이언트는 OnSimpleVolumeChanged 메서드의 구현에서 인식할 수 있는 EventContext 매개 변수 값을 전달합니다.

IAudioSessionEvents 인터페이스에서 메서드를 구현하는 코드 예제는 오디오 세션 이벤트를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	audiopolicy.h

추가 정보

IAudioSessionEvents 인터페이스

ISimpleAudioVolume::SetMasterVolume

ISimpleAudioVolume::SetMute