IAudioSessionControl 인터페이스(audiopolicy.h)

  • 아티클

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

또는 클라이언트는 먼저 스트림 개체를 만들고 세션에 스트림을 추가하지 않고도 기존 세션의 IAudioSessionControl 인터페이스를 가져올 수 있습니다. 대신 클라이언트는 AudioSessionGuid 매개 변수가 세션 GUID로 설정된 IAudioSessionManager::GetAudioSessionControl 메서드를 호출합니다.

클라이언트가 IAudioSessionControl 인터페이스의 메서드를 통해 세션 매개 변수를 변경할 때 클라이언트는 세션 관리자로부터 알림을 받도록 등록할 수 있습니다.

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

IAudioSessionControl 인터페이스는 오디오 세션을 제어합니다. 오디오 세션은 공유 모드 스트림의 컬렉션입니다. 이 인터페이스는 배타적 모드 스트림에서 작동하지 않습니다.

IAudioSessionControl 인터페이스를 사용하는 코드 예제는 레거시 오디오 애플리케이션에 대한 오디오 이벤트를 참조하세요.

상속

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

메서드

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

 
IAudioSessionControl::GetDisplayName

GetDisplayName 메서드는 오디오 세션의 표시 이름을 검색합니다.
IAudioSessionControl::GetGroupingParam

GetGroupingParam 메서드는 오디오 세션의 그룹화 매개 변수를 검색합니다.
IAudioSessionControl::GetIconPath

GetIconPath 메서드는 오디오 세션의 표시 아이콘 경로를 검색합니다.
IAudioSessionControl::GetState

GetState 메서드는 오디오 세션의 현재 상태를 검색합니다.
IAudioSessionControl::RegisterAudioSessionNotification

RegisterAudioSessionNotification 메서드는 스트림 상태의 변경 내용을 포함하여 세션 이벤트의 알림을 수신하도록 클라이언트를 등록합니다.
IAudioSessionControl::SetDisplayName

SetDisplayName 메서드는 현재 세션에 표시 이름을 할당합니다.
IAudioSessionControl::SetGroupingParam

SetGroupingParam 메서드는 세션을 세션 그룹화에 할당합니다.
IAudioSessionControl::SetIconPath

SetIconPath 메서드는 현재 세션에 표시 아이콘을 할당합니다.
IAudioSessionControl::UnregisterAudioSessionNotification

UnregisterAudioSessionNotification 메서드는 알림을 받기 위해 클라이언트에서 이전 등록을 삭제합니다.

요구 사항

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

추가 정보

핵심 오디오 인터페이스

IAudioClient::GetService

IAudioClient::Initialize

IAudioSessionManager::GetAudioSessionControl

WASAPI