IAudioSessionEvents 인터페이스(audiopolicy.h)
IAudioSessionEvents 인터페이스는 볼륨 수준 변경, 표시 이름 및 세션 상태와 같은 세션 관련 이벤트에 대한 알림을 제공합니다. WASAPI 시스템 구성 요소에 의해 구현되는 이 섹션의 다른 인터페이스와 달리 WASAPI 클라이언트는 IAudioSessionEvents 인터페이스를 구현합니다. 이벤트 알림을 수신하기 위해 클라이언트는 IAudioSessionEvents 인터페이스에 대한 포인터를 IAudioSessionControl::RegisterAudioSessionNotification 메서드에 전달합니다.
IAudioClientSessionEvents 인터페이스를 등록한 후 클라이언트는 인터페이스의 메서드를 통해 콜백 형식으로 이벤트 알림을 받습니다.
IAudioSessionEvents 인터페이스를 구현할 때 클라이언트는 교착 상태 및 정의되지 않은 동작을 방지하기 위해 다음 규칙을 준수해야 합니다.
- 인터페이스의 메서드는 차단 해제여야 합니다. 클라이언트는 이벤트 콜백 중에 동기화 개체를 기다리지 않아야 합니다.
- 클라이언트는 이벤트 콜백 중에 IAudioSessionControl::UnregisterAudioSessionNotification 메서드를 호출해서는 안 됩니다.
- 클라이언트는 이벤트 콜백 중에 WASAPI 개체에 대한 최종 참조를 해제해서는 안 됩니다.
상속
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