> ## 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.

# AudioStateMonitorCallback

> AudioStateMonitorCallback

# AudioStateMonitorCallback

[IAudioStateMonitor::RegisterCallback](https://devdocs.xbox.com/ko/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback.md)를 호출하여 등록되는 콜백 함수로, [IAudioStateMonitor](https://devdocs.xbox.com/ko/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor.md)와 연결된 오디오 스트림의 사운드 레벨이 변경될 때 시스템에 의해 호출됩니다.

## Syntax

```cpp theme={null}
void CALLBACK AudioStateMonitorCallback(
  IAudioStateMonitor *audioStateMonitor,
  void *context
);
```

### Parameters

*audioStateMonitor* \_Out\_\
Type: IAudioStateMonitor\*

콜백이 등록된 [IAudioStateMonitor](https://devdocs.xbox.com/ko/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor.md) 인터페이스입니다. 관련 오디오 스트림의 새로운 현재 사운드 레벨을 가져오려면 인터페이스의 [GetSoundLevel](https://devdocs.xbox.com/ko/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-getsoundlevel.md) 메서드를 호출하세요.

*context*\
Type: void\*

`RegisterCallback` 메서드에 전달된 앱 정의 컨텍스트 객체입니다.

### Return value

이 콜백 함수는 값을 반환하지 않습니다.

## Remarks

편의를 위해 Audiostatemonitorapi.h는 이 콜백에 대한 포인터 타입을 **PAudioStateMonitorCallback**로 정의합니다.

다음 코드 예제는 `AudioStateMonitor`에 새 콜백을 등록하는 방법을 보여줍니다. 편의를 위해 *Audiostatemonitorapi.h*는 이 콜백에 대한 포인터 타입을 `PAudioStateMonitorCallback`로 정의합니다.

```cpp theme={null}
// Registers a new callback with the AudioStateMonitor.

    STDMETHOD(RegisterCallback) (_In_ PAudioStateMonitorCallback callback, _In_opt_ void* context, _Out_ AudioStateMonitorRegistrationHandle* registration) PURE;
```

## Requirements

**Header:** Audiostatemonitorapi.h

**지원 플랫폼:** 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](https://devdocs.xbox.com/ko/build/console-features/audio/overviews/wasapi-overview.md)


## Related topics

- [IAudioStateMonitor::RegisterCallback method](https://devdocs.xbox.com/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback.md)
- [Méthode IAudioStateMonitor::RegisterCallback](https://devdocs.xbox.com/fr-CA/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback.md)
- [IAudioStateMonitor::RegisterCallback, méthode](https://devdocs.xbox.com/fr/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback.md)
- [Método IAudioStateMonitor::RegisterCallback](https://devdocs.xbox.com/pt-BR/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback.md)
- [IAudioStateMonitor::RegisterCallback 方法](https://devdocs.xbox.com/zh-CN/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback.md)