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

# CreateCaptureAudioStateMonitorForCategoryAndDeviceId

> CreateCaptureAudioStateMonitorForCategoryAndDeviceId

# CreateCaptureAudioStateMonitorForCategoryAndDeviceId

\[Algumas informações se referem a produtos em pré-lançamento que podem ser substancialmente modificados antes do lançamento comercial. A Microsoft não oferece garantias, expressas ou implícitas, com relação às informações fornecidas aqui.]

Cria uma nova instância de [IAudioStateMonitor](https://docs.xbox.com/pt-BR/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor.md) que monitora o nível de áudio de todos os fluxos de captura de áudio na categoria especificada para o ponto de extremidade de áudio com a ID de `device` especificada.

## Sintaxe

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

### Parâmetros

*category*\
Tipo: AUDIO\_STREAM\_CATEGORY

Um membro da enumeração **AUDIO\_STREAM\_CATEGORY** que especifica a categoria dos fluxos de captura de áudio a serem monitorados.

*deviceId*\
Tipo: PCWSTR

Uma ID de dispositivo que especifica o ponto de extremidade de áudio cujos fluxos de captura de áudio são monitorados.

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

Este parâmetro de saída é preenchido com o objeto `IAudioStateMonitor` criado.

### Valor de retorno

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará `S\_OK`.

## Comentários

Esta é uma das funções que criam e retornam uma instância de `AudioStateMonitor`.

Há quatro variantes para cada fluxo de captura e de renderização que determinam se um processo pode realizar uma das seguintes ações para uma determinada função:

* Capturar ou renderizar qualquer áudio de qualquer categoria
* Capturar ou renderizar áudio de uma categoria específica
* Capturar ou renderizar áudio de uma categoria específica, para um ponto de extremidade específico.\
  O ponto de extremidade pode ser especificado usando a ID `MMDevice` (obtida usando `IMMDevice::GetId()`) ou usando sua ID `SWD` (obtida usando `Windows.Devices.Enumeration` ou `Windows.Media.Devices.MediaDevice`)
* Capturar ou renderizar áudio de uma categoria específica para o ponto de extremidade padrão

## Requisitos

**Cabeçalho:** Audiostatemonitorapi.h

**Biblioteca:** Windows.Media.MediaControl.lib

**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](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/wasapi-overview.md)

[Visão geral do XAudio2](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/xaudio2-overview.md)

[Visão geral de áudio](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/audio.md)


## Related topics

- [Interface IAudioStateMonitor](https://docs.xbox.com/pt-BR/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor.md)
- [AudioStateMonitor](https://docs.xbox.com/pt-BR/reference/audio/audiostatemonitor/audiostatemonitor_members.md)
- [CreateCaptureAudioStateMonitorForCategory](https://docs.xbox.com/pt-BR/reference/audio/audiostatemonitor/functions/createcaptureaudiostatemonitorforcategory.md)
- [CreateCaptureAudioStateMonitorForCategoryAndDeviceRole](https://docs.xbox.com/pt-BR/reference/audio/audiostatemonitor/functions/createcaptureaudiostatemonitorforcategoryanddevicerole.md)
- [CreateCaptureAudioStateMonitor](https://docs.xbox.com/pt-BR/reference/audio/audiostatemonitor/functions/createcaptureaudiostatemonitor.md)