> ## 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](/zh-TW/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback) 所註冊的回呼函式，系統會在與 [IAudioStateMonitor](/zh-TW/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor) 相關聯之音訊串流的音量層級變更時呼叫此函式。

## 語法

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

### 參數

*audioStateMonitor* \_Out\_\
類型: IAudioStateMonitor\*

註冊回呼時所用的 [IAudioStateMonitor](/zh-TW/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor) 介面。呼叫該介面的 [GetSoundLevel](/zh-TW/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-getsoundlevel) 方法，以取得相關聯音訊串流新的目前音量層級。

*context*\
類型: void\*

傳遞至 `RegisterCallback` 方法的應用程式定義內容物件。

### 傳回值

此回呼函式不會傳回值。

## 備註

為了方便起見，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;
```

## 需求

**標頭：** Audiostatemonitorapi.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[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](/zh-TW/build/console-features/audio/overviews/wasapi-overview)


## Related topics

- [IAudioStateMonitor::RegisterCallback method](/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback.md)
- [Método IAudioStateMonitor::RegisterCallback](/es/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback.md)
- [IAudioStateMonitor::RegisterCallback 方法](/zh-CN/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback.md)
- [AudioStateMonitor](/reference/audio/audiostatemonitor/audiostatemonitor_members.md)
- [IAudioStateMonitor::RegisterCallback メソッド](/ja-jp/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback.md)