Skip to main content

CreateRenderAudioStateMonitorForCategoryAndDeviceRole

[Algumas informações estão relacionadas a produtos de 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 renderização de áudio na categoria especificada e com a função especificada.

Sintaxe

Parâmetros

category
Tipo: AUDIO_STREAM_CATEGORY
Um membro da enumeração AUDIO_STREAM_CATEGORY que especifica a categoria dos fluxos de renderização de áudio a serem monitorados. role
Tipo: ERole
Um membro da enumeração ERole que especifica a função dos fluxos de renderização de áudio a serem monitorados. audioStateMonitor _Out_
Tipo: IAudioStateMonitor**
Esse parâmetro de saída é preenchido com o objeto IAudioStateMonitor criado.

Valor de retorno

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 fluxos de captura e para fluxos 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 a ID SWD dele (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
Considere o cenário a seguir, em que um jogo opta por reproduzir áudio GameMedia somente quando se sabe que o áudio não será silenciado pelo sistema operacional devido a uma política. Para isso, o jogo se registra para receber notificações de SoundLevel para a categoria de fluxo AudioCategory_GameMedia no ponto de extremidade de console padrão. Se o SoundLevel dessa categoria estiver definido como ‘Muted’, o jogo interromperá a reprodução do fluxo GameMedia. Se o SoundLevel estiver definido como qualquer outro valor, o jogo optará por reproduzir o fluxo GameMedia.

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 áudio
Last modified on October 6, 2026