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 |