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

A função de retorno de chamada, registrada chamando [IAudioStateMonitor::RegisterCallback](/pt-BR/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback), é chamada pelo sistema quando o nível de som dos fluxos de áudio associados ao [IAudioStateMonitor](/pt-BR/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor) muda.

## Sintaxe

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

### Parâmetros

*audioStateMonitor* \_Out\_\
Tipo: IAudioStateMonitor\*

A interface [IAudioStateMonitor](/pt-BR/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor) com a qual o retorno de chamada foi registrado. Chame o método [GetSoundLevel](/pt-BR/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-getsoundlevel) da interface para obter o novo nível de som atual dos fluxos de áudio associados.

*context*\
Tipo: void\*

Um objeto de contexto definido pelo aplicativo passado para o método `RegisterCallback`.

### Valor de retorno

Esta função de retorno de chamada não retorna um valor.

## Comentários

Por conveniência, Audiostatemonitorapi.h define um tipo de ponteiro para esse retorno de chamada como **PAudioStateMonitorCallback**.

O exemplo de código a seguir mostra como registrar um novo retorno de chamada com `AudioStateMonitor`. Por conveniência, *Audiostatemonitorapi.h* define um tipo de ponteiro para esse retorno de chamada como `PAudioStateMonitorCallback`.

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

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

## Requisitos

**Cabeçalho:** Audiostatemonitorapi.h

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[AUDIO\_STREAM\_CATEGORY](https://learn.microsoft.com/windows/win32/api/audiosessiontypes/ne-audiosessiontypes-audio_stream_category)

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

[WASAPI](/pt-BR/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)