IAudioStreamVolume 인터페이스(audioclient.h)
IAudioStreamVolume 인터페이스를 사용하면 클라이언트가 오디오 스트림의 모든 채널에 대한 볼륨 수준을 제어하고 모니터링할 수 있습니다. 클라이언트는 REFIID IID_IAudioStreamVolume 설정된 매개 변수 riid를 사용하여 IAudioClient::GetService 메서드를 호출하여 스트림 개체에서 IAudioStreamVolume 인터페이스에 대한 참조를 가져옵니다.
스피커에서 들을 수 있듯이 세션 서브믹스에 있는 모든 채널의 유효 볼륨 수준은 다음 네 가지 볼륨 수준 요소의 산물입니다.
- 클라이언트가 IAudioStreamVolume 인터페이스의 메서드를 통해 제어할 수 있는 세션 내 스트림의 채널별 볼륨 수준입니다.
- 클라이언트가 IChannelAudioVolume 인터페이스의 메서드를 통해 제어할 수 있는 세션의 채널별 볼륨 수준입니다.
- 클라이언트가 ISimpleAudioVolume 인터페이스의 메서드를 통해 제어할 수 있는 세션의 master 볼륨 수준입니다.
- 전역 혼합이 변경되면 시스템이 세션에 동적으로 할당하는 세션의 정책 기반 볼륨 수준입니다.
instance IAudioStreamVolume 인터페이스를 해제할 때 클라이언트는 개체를 만든 IAudioClient::GetService 호출과 동일한 스레드에서 인터페이스의 Release 메서드를 호출해야 합니다.
IAudioStreamVolume 인터페이스는 공유 모드 오디오 스트림의 채널 볼륨을 제어합니다. 이 인터페이스는 배타적 모드 스트림에서 작동하지 않습니다. 단독 모드 스트림의 볼륨 컨트롤에 대한 자세한 내용은 EndpointVolume API를 참조하세요.
상속
IAudioStreamVolume 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IAudioStreamVolume 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IAudioStreamVolume 인터페이스에는 이러한 메서드가 있습니다.
| IAudioStreamVolume::GetAllVolumes GetAllVolumes 메서드는 오디오 스트림의 모든 채널에 대한 볼륨 수준을 검색합니다. |
| IAudioStreamVolume::GetChannelCount GetChannelCount 메서드는 오디오 스트림의 채널 수를 검색합니다. |
| IAudioStreamVolume::GetChannelVolume GetChannelVolume 메서드는 오디오 스트림에서 지정된 채널의 볼륨 수준을 검색합니다. |
| IAudioStreamVolume::SetAllVolumes SetAllVolumes 메서드는 오디오 스트림의 모든 채널에 대한 개별 볼륨 수준을 설정합니다. |
| IAudioStreamVolume::SetChannelVolume SetChannelVolume 메서드는 오디오 스트림에서 지정된 채널의 볼륨 수준을 설정합니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | audioclient.h |