IChannelAudioVolume 인터페이스(audioclient.h)

IChannelAudioVolume 인터페이스를 사용하면 클라이언트가 스트림이 속한 오디오 세션의 모든 채널에 대한 볼륨 수준을 제어하고 모니터링할 수 있습니다. IAudioClient::Initialize 메서드를 호출하는 동안 클라이언트가 스트림을 할당한 세션입니다. 클라이언트는 REFIID IID_IChannelAudioVolume 설정된 매개 변수 riid를 사용하여 IAudioClient::GetService 메서드를 호출하여 스트림 개체에서 IChannelAudioVolume 인터페이스에 대한 참조를 가져옵니다.

스피커에서 들을 수 있듯이 세션 서브믹스에 있는 모든 채널의 유효 볼륨 수준은 다음 네 가지 볼륨 수준 요소의 산물입니다.

• 클라이언트가 IAudioStreamVolume 인터페이스의 메서드를 통해 제어할 수 있는 세션 내 스트림의 채널별 볼륨 수준입니다.
• 클라이언트가 IChannelAudioVolume 인터페이스의 메서드를 통해 제어할 수 있는 세션의 채널별 볼륨 수준입니다.
• 클라이언트가 ISimpleAudioVolume 인터페이스의 메서드를 통해 제어할 수 있는 세션의 master 볼륨 수준입니다.
• 전역 혼합이 변경되면 시스템이 세션에 동적으로 할당하는 세션의 정책 기반 볼륨 수준입니다.

이전 목록의 4개 볼륨 수준 요소는 각각 0.0에서 1.0 범위의 값입니다. 여기서 0.0은 무음, 1.0은 전체 볼륨(감쇠 없음)을 나타냅니다. 유효 볼륨 수준은 0.0~1.0 범위의 값이기도 합니다.

일반적인 오디오 애플리케이션은 세션의 볼륨 수준을 수정하지 않습니다. 대신 사용자가 Sndvol 프로그램을 통해 이러한 볼륨 수준을 설정하는 데 의존합니다. Sndvol은 세션의 master 볼륨 수준만 수정합니다. 기본적으로 세션 관리자는 세션의 초기 활성화 시 채널별 볼륨 수준을 1.0으로 설정합니다. 클라이언트의 후속 채널별 볼륨 변경은 컴퓨터 다시 시작에서 지속됩니다.

instance IChannelAudioVolume 인터페이스를 해제할 때 클라이언트는 개체를 만든 IAudioClient::GetService 호출과 동일한 스레드에서 인터페이스의 Release 메서드를 호출해야 합니다.

IChannelAudioVolume 인터페이스는 오디오 세션의 채널 볼륨을 제어합니다. 오디오 세션은 공유 모드 스트림의 컬렉션입니다. 이 인터페이스는 배타적 모드 스트림에서 작동하지 않습니다. 단독 모드 스트림의 볼륨 컨트롤에 대한 자세한 내용은 EndpointVolume API를 참조하세요.

상속

IChannelAudioVolume 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IChannelAudioVolume 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IChannelAudioVolume 인터페이스에는 이러한 메서드가 있습니다.

IChannelAudioVolume::GetAllVolumes GetAllVolumes 메서드는 오디오 세션의 모든 채널에 대한 볼륨 수준을 검색합니다.
IChannelAudioVolume::GetChannelCount GetChannelCount 메서드는 오디오 세션에 대한 스트림 형식의 채널 수를 검색합니다.
IChannelAudioVolume::GetChannelVolume GetChannelVolume 메서드는 오디오 세션에서 지정된 채널의 볼륨 수준을 검색합니다.
IChannelAudioVolume::SetAllVolumes SetAllVolumes 메서드는 오디오 세션의 모든 채널에 대한 개별 볼륨 수준을 설정합니다.
IChannelAudioVolume::SetChannelVolume SetChannelVolume 메서드는 오디오 세션에서 지정된 채널의 볼륨 수준을 설정합니다.

요구 사항

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

추가 정보

핵심 오디오 인터페이스

IAudioClient::GetService

IAudioClient::Initialize

IAudioStreamVolume 인터페이스

ISimpleAudioVolume 인터페이스

WASAPI