Skip to main content

CreateCaptureAudioStateMonitorForCategory

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

Syntax

Parameters

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

Return value

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

Remarks

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

Requirements

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

See also

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