다음을 통해 공유


IAudioSessionEvents 인터페이스(audiopolicy.h)

IAudioSessionEvents 인터페이스는 볼륨 수준 변경, 표시 이름 및 세션 상태와 같은 세션 관련 이벤트에 대한 알림을 제공합니다. WASAPI 시스템 구성 요소에 의해 구현되는 이 섹션의 다른 인터페이스와 달리 WASAPI 클라이언트는 IAudioSessionEvents 인터페이스를 구현합니다. 이벤트 알림을 수신하기 위해 클라이언트는 IAudioSessionEvents 인터페이스에 대한 포인터를 IAudioSessionControl::RegisterAudioSessionNotification 메서드에 전달합니다.

IAudioClientSessionEvents 인터페이스를 등록한 후 클라이언트는 인터페이스의 메서드를 통해 콜백 형식으로 이벤트 알림을 받습니다.

IAudioSessionEvents 인터페이스를 구현할 때 클라이언트는 교착 상태 및 정의되지 않은 동작을 방지하기 위해 다음 규칙을 준수해야 합니다.

  • 인터페이스의 메서드는 차단 해제여야 합니다. 클라이언트는 이벤트 콜백 중에 동기화 개체를 기다리지 않아야 합니다.
  • 클라이언트는 이벤트 콜백 중에 IAudioSessionControl::UnregisterAudioSessionNotification 메서드를 호출해서는 안 됩니다.
  • 클라이언트는 이벤트 콜백 중에 WASAPI 개체에 대한 최종 참조를 해제해서는 안 됩니다.
IAudioSessionEvents 인터페이스를 구현하는 코드 예제는 오디오 세션 이벤트를 참조하세요. 알림을 받을 클라이언트의 IAudioSessionEvents 인터페이스를 등록하는 코드 예제는 레거시 오디오 애플리케이션에 대한 오디오 이벤트를 참조하세요.

상속

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

메서드

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

 
IAudioSessionEvents::OnChannelVolumeChanged

OnChannelVolumeChanged 메서드는 세션 서브믹스의 오디오 채널 볼륨 수준이 변경되었음을 클라이언트에 알릴 수 있습니다.
IAudioSessionEvents::OnDisplayNameChanged

OnDisplayNameChanged 메서드는 세션의 표시 이름이 변경되었음을 클라이언트에 알렸습니다.
IAudioSessionEvents::OnGroupingParamChanged

OnGroupingParamChanged 메서드는 세션의 그룹화 매개 변수가 변경되었음을 클라이언트에 알렸습니다.
IAudioSessionEvents::OnIconPathChanged

OnIconPathChanged 메서드는 세션의 표시 아이콘이 변경되었음을 클라이언트에 알렸습니다.
IAudioSessionEvents::OnSessionDisconnected

OnSessionDisconnected 메서드는 클라이언트에 오디오 세션의 연결이 끊어졌는지 알 수 있습니다.
IAudioSessionEvents::OnSimpleVolumeChanged

OnSimpleVolumeChanged 메서드는 오디오 세션의 볼륨 수준 또는 음소거 상태가 변경되었음을 클라이언트에 알릴 수 있습니다.
IAudioSessionEvents::OnStateChanged

OnStateChanged 메서드는 세션의 스트림 활동 상태가 변경되었음을 클라이언트에 알렸습니다.

요구 사항

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

추가 정보

핵심 오디오 인터페이스

IAudioSessionControl::RegisterAudioSessionNotification

IAudioSessionControl::UnregisterAudioSessionNotification

WASAPI