Skip to main content

CreateRenderAudioStateMonitorForCategoryAndDeviceRole

[일부 정보는 상용 출시 전에 크게 변경될 수 있는 사전 출시 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 명시적이든 묵시적이든 어떠한 보증도 하지 않습니다.] 지정된 카테고리와 지정된 역할을 가진 모든 오디오 렌더링 스트림의 오디오 레벨을 모니터링하는 IAudioStateMonitor의 새 인스턴스를 만듭니다.

Syntax

Parameters

category
Type: AUDIO_STREAM_CATEGORY
모니터링할 오디오 렌더링 스트림의 카테고리를 지정하는 AUDIO_STREAM_CATEGORY 열거형의 멤버입니다. role
Type: ERole
모니터링할 오디오 렌더링 스트림의 역할을 지정하는 ERole 열거형의 멤버입니다. audioStateMonitor _Out_
Type: IAudioStateMonitor**
이 출력 매개변수에는 생성된 IAudioStateMonitor 객체가 채워집니다.

Return value

메서드가 성공하면 S\_OK를 반환합니다.

Remarks

이 함수는 AudioStateMonitor 인스턴스를 생성하고 반환하는 함수들 중 하나입니다. 캡처 및 렌더링 스트림 각각에 대해 네 가지 변형이 있으며, 프로세스가 특정 역할에 대해 다음 중 하나를 수행할 수 있는지 결정합니다:
  • 모든 카테고리의 오디오를 캡처 또는 렌더링
  • 특정 카테고리의 오디오를 캡처 또는 렌더링
  • 특정 카테고리의 오디오를 특정 엔드포인트로 캡처 또는 렌더링
    엔드포인트는 MMDevice ID(IMMDevice::GetId()를 사용하여 얻음)나 SWD ID(Windows.Devices.Enumeration 또는 Windows.Media.Devices.MediaDevice를 사용하여 얻음)로 지정할 수 있습니다.
  • 특정 카테고리의 오디오를 기본 엔드포인트로 캡처 또는 렌더링
다음 시나리오를 고려해 보세요. 게임이 정책상 OS에 의해 오디오가 음소거되지 않을 것이 확실할 때만 GameMedia 오디오를 재생하도록 선택합니다. 이를 위해 게임은 기본 콘솔 엔드포인트에서 AudioCategory_GameMedia 스트림 카테고리에 대한 SoundLevel 알림에 등록합니다. 이 카테고리의 SoundLevel이 ‘Muted’로 설정되면 게임은 GameMedia 스트림의 재생을 중지합니다. SoundLevel이 다른 값으로 설정되면 게임은 GameMedia 스트림을 재생하도록 선택합니다.

Requirements

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

See also

AUDIO_STREAM_CATEGORY WASAPI 소개 WASAPI 오디오 개요
마지막 수정일 2026년 8월 31일