Skip to main content

IAudioStateMonitor interface

데스크톱 앱 및 게임이 시스템에 의해 오디오 스트림의 사운드 레벨이 수정되는 시점을 발견할 수 있도록 메서드를 제공합니다. 여기에는 다음과 같은 시나리오가 포함됩니다:
  • 오디오 앱이 백그라운드에서 재생되어 게임 미디어 스트림이 음소거되는 시점을 파악
  • VoIP 통화가 백그라운드에서 시작되어 게임 채팅 오디오 스트림을 중지해야 하는 시점을 파악
데스크톱 앱 및 게임이 시스템에 의해 오디오 스트림의 사운드 레벨이 수정되는 시점을 결정할 수 있는 메서드를 제공합니다. 여기에는 게임이나 앱이 다음을 결정해야 하는 시나리오가 포함됩니다:
  • 오디오 앱이 백그라운드에서 재생되어 게임 미디어 스트림이 음소거되는 시점
  • VoIP 통화가 백그라운드에서 시작되어 게임 채팅 오디오 스트림을 중지해야 하는 시점
렌더링 스트림뿐만 아니라 캡처 스트림에 대해서도 사운드 레벨을 확인하고 모니터링할 수 있습니다. 모니터링되는 스트림은 카테고리, 오디오 엔드포인트 또는 장치 역할에 따라 선택할 수 있습니다. 새 스트림이 갖게 될 사운드 레벨은 스트림이 생성되기 전에 확인할 수 있습니다. 이 API는 UWP 앱에서 사용할 수 있지만 데스크톱 앱과 게임에서는 사용할 수 없는 Windows.Media.Audio.AudiostateMonitor 클래스와 동등합니다. 이 인터페이스는 UWP 앱에서는 사용할 수 없습니다.

Members

IAudioStateMonitor 인터페이스는 IUnknown 인터페이스를 상속하지만 다음과 같은 유형의 멤버도 갖습니다:

Methods

IAudioStateMonitor 인터페이스에는 다음 메서드가 있습니다:

Remarks

이 인터페이스의 인스턴스를 얻으려면 다음 메서드 중 하나를 호출하세요: 다음 예제 코드는 게임이 AudioCategory_GameMedia 카테고리의 오디오 렌더링 스트림에 대한 오디오 레벨 알림에 등록하는 시나리오를 보여줍니다. 이 카테고리의 사운드 레벨이 음소거되면 게임은 게임 미디어 스트림의 재생을 중지합니다. 사운드 레벨이 다른 값으로 설정되면 게임 미디어 스트림이 재생됩니다.

Requirements

Header: Audiostatemonitorapi.h 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

See also

WASAPI 소개
마지막 수정일 2026년 8월 24일