> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateCaptureAudioStateMonitorForCategoryAndDeviceId

> CreateCaptureAudioStateMonitorForCategoryAndDeviceId

# CreateCaptureAudioStateMonitorForCategoryAndDeviceId

\[일부 정보는 상용 출시 전에 크게 변경될 수 있는 사전 출시 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 명시적이든 묵시적이든 어떠한 보증도 하지 않습니다.]

지정된 `device` ID를 가진 오디오 엔드포인트에 대해, 지정된 카테고리에 속한 모든 오디오 캡처 스트림의 오디오 레벨을 모니터링하는 [IAudioStateMonitor](/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor)의 새 인스턴스를 만듭니다.

## Syntax

```cpp theme={null}
HRESULT WINAPI CreateCaptureAudioStateMonitorForCategoryAndDeviceId(
  AUDIO_STREAM_CATEGORY category,
  PCWSTR deviceId,
  _Out_ IAudioStateMonitor **audioStateMonitor
);
```

### 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](https://learn.microsoft.com/windows/win32/api/audiosessiontypes/ne-audiosessiontypes-audio_stream_category)

[WASAPI 소개](https://learn.microsoft.com/windows/desktop/CoreAudio/wasapi)

[WASAPI](/build/console-features/audio/overviews/wasapi-overview)

[XAudio2 개요](/build/console-features/audio/overviews/xaudio2-overview)

[오디오 개요](/build/console-features/audio/overviews/audio)


## Related topics

- [IAudioStateMonitor interface](/ko/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor.md)
- [AudioStateMonitor](/ko/reference/audio/audiostatemonitor/audiostatemonitor_members.md)
- [CreateCaptureAudioStateMonitorForCategory](/ko/reference/audio/audiostatemonitor/functions/createcaptureaudiostatemonitorforcategory.md)
- [CreateCaptureAudioStateMonitorForCategoryAndDeviceRole](/ko/reference/audio/audiostatemonitor/functions/createcaptureaudiostatemonitorforcategoryanddevicerole.md)
- [CreateRenderAudioStateMonitorForCategoryAndDeviceId](/ko/reference/audio/audiostatemonitor/functions/createrenderaudiostatemonitorforcategoryanddeviceid.md)