Skip to main content

​
CreateCaptureAudioStateMonitorForCategoryAndDeviceId

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

​
Syntax

​
Parameters

category
Type: AUDIO_STREAM_CATEGORY 모니터링할 오디오 캡처 스트림의 카테고리를 지정하는 AUDIO_STREAM_CATEGORY 열거형의 멤버입니다. deviceId
Type: PCWSTR 오디오 캡처 스트림을 모니터링할 오디오 엔드포인트를 지정하는 장치 ID입니다. 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를 사용하여 얻음)로 지정할 수 있습니다.
  • 특정 카테고리의 오디오를 기본 엔드포인트로 캡처 또는 렌더링

​
Requirements

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

​
See also

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

관련 항목

IAudioStateMonitor interfaceAudioStateMonitorCreateCaptureAudioStateMonitorForCategoryCreateCaptureAudioStateMonitorForCategoryAndDeviceRoleCreateRenderAudioStateMonitorForCategoryAndDeviceId