IAudioSessionEvents::OnChannelVolumeChanged 메서드(audiopolicy.h)
OnChannelVolumeChanged 메서드는 세션 서브믹스의 오디오 채널 볼륨 수준이 변경되었음을 클라이언트에 알릴 수 있습니다.
구문
HRESULT OnChannelVolumeChanged(
[in] DWORD ChannelCount,
[in] float [] NewChannelVolumeArray,
[in] DWORD ChangedChannel,
[in] LPCGUID EventContext
);
매개 변수
[in] ChannelCount
채널 수입니다. 이 매개 변수는 세션 서브믹스의 오디오 채널 수를 지정합니다.
[in] NewChannelVolumeArray
볼륨 수준 배열에 대한 포인터입니다. 각 요소는 특정 채널의 볼륨 수준을 지정하는 float 형식의 값입니다. 각 볼륨 수준은 0.0에서 1.0 범위의 값입니다. 여기서 0.0은 무음이고 1.0은 전체 볼륨(감쇠 없음)입니다. 배열의 요소 수는 ChannelCount 매개 변수로 지정됩니다. 오디오 스트림에 n 채널이 포함된 경우 채널 번호는 0에서 n– 1로 지정됩니다. 인덱스가 채널 번호와 일치하는 배열 요소에는 해당 채널의 볼륨 수준이 포함됩니다. 배열이 호출 기간 동안만 유효하다고 가정합니다.
[in] ChangedChannel
볼륨 수준이 변경된 채널의 수입니다. 이 값을 NewChannelVolumeArray 배열의 인덱스로 사용합니다. 세션 서브믹스에 n 채널이 포함된 경우 채널 번호는 0에서 n– 1로 지정됩니다. 둘 이상의 채널이 변경되었을 수 있는 경우(예: IChannelAudioVolume::SetAllVolumes 메서드 호출의 결과로) ChangedChannel 값은 (DWORD)(–1)입니다.
[in] EventContext
이벤트 컨텍스트 값입니다. 이는 호출자가 채널의 볼륨 수준 변경을 시작한 호출에서 IChannelAudioVolume::SetChannelVolume 또는 IChannelAudioVolume::SetAllVolumes 메서드에 전달한 값과 동일합니다. 자세한 내용은 설명 부분을 참조하세요.
반환 값
메서드가 성공하면 S_OK가 반환되고, 그렇지 않으면 오류 코드가 반환됩니다.
설명
세션 관리자는 IChannelAudioVolume::SetChannelVolume 또는 IChannelAudioVolume::SetAllVolumes 메서드를 호출할 때마다 세션 서브믹스에서 하나 이상의 채널의 볼륨 수준을 성공적으로 업데이트할 때마다 이 메서드를 호출합니다. OnChannelVolumeChanged 호출은 새 채널 볼륨 수준 또는 수준이 이전 채널 볼륨 수준 또는 수준과 다른지 여부에 관계없이 발생합니다.
EventContext 매개 변수는 클라이언트가 시작한 채널 볼륨 변경 내용과 다른 클라이언트가 시작한 채널 볼륨 변경을 구분하는 수단을 제공합니다. IChannelAudioVolume::SetChannelVolume 또는 IChannelAudioVolume::SetAllVolumes 메서드를 호출할 때 클라이언트는 OnChannelVolumeChanged 메서드의 구현에서 인식할 수 있는 EventContext 매개 변수 값을 전달합니다.
IAudioSessionEvents 인터페이스에서 메서드를 구현하는 코드 예제는 오디오 세션 이벤트를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | audiopolicy.h |