ISimpleAudioVolume 인터페이스(audioclient.h)

ISimpleAudioVolume 인터페이스를 사용하면 클라이언트가 오디오 세션의 master 볼륨 수준을 제어할 수 있습니다. IAudioClient::Initialize 메서드는 스트림 개체를 초기화하고 스트림을 오디오 세션에 할당합니다. 클라이언트는 reFIID IID_ISimpleAudioVolume 설정된 매개 변수 riid를 사용하여 IAudioClient::GetService 메서드를 호출하여 스트림 개체에서 ISimpleAudioVolume 인터페이스에 대한 참조를 가져옵니다.

또는 클라이언트는 먼저 스트림 개체를 만들고 세션에 스트림을 추가하지 않고도 기존 세션의 ISimpleAudioVolume 인터페이스를 가져올 수 있습니다. 대신 클라이언트는 세션 GUID를 사용하여 IAudioSessionManager::GetSimpleAudioVolume 메서드를 호출합니다.

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

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

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

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

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

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

상속

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

메서드

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

ISimpleAudioVolume::GetMasterVolume GetMasterVolume 메서드는 오디오 세션에 대한 클라이언트 볼륨 수준을 검색합니다.
ISimpleAudioVolume::GetMute GetMute 메서드는 오디오 세션의 현재 음소거 상태를 검색합니다.
ISimpleAudioVolume::SetMasterVolume SetMasterVolume 메서드는 오디오 세션의 master 볼륨 수준을 설정합니다.
ISimpleAudioVolume::SetMute SetMute 메서드는 오디오 세션의 음소거 상태를 설정합니다.

요구 사항

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

추가 정보

핵심 오디오 인터페이스

IAudioClient::GetService

IAudioClient::Initialize

IAudioStreamVolume 인터페이스

IChannelAudioVolume 인터페이스

WASAPI