Skip to main content

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

​
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 Sobre o WASAPI WASAPI Visão geral do XAudio2 Visão geral de áudio
Last modified on October 6, 2026