Skip to main content

Interface IAudioStateMonitor

Fornece métodos para que aplicativos da área de trabalho e jogos descubram quando os níveis de som dos fluxos de áudio são modificados pelo sistema. Isso inclui cenários como os seguintes:
  • Saber quando um fluxo de mídia do jogo é silenciado porque um aplicativo de áudio está sendo reproduzido em segundo plano ou
  • Saber quando interromper um fluxo de áudio de chat do jogo porque uma chamada VOIP foi iniciada em segundo plano.
Fornece métodos que permitem que aplicativos da área de trabalho e jogos determinem o momento em que os níveis de som dos fluxos de áudio são modificados pelo sistema. Isso inclui cenários em que um jogo ou aplicativo precisa determinar o seguinte:
  • O momento em que um fluxo de mídia do jogo é silenciado porque um aplicativo de áudio está sendo reproduzido em segundo plano
  • O momento de interromper um fluxo de áudio de chat do jogo porque uma chamada VoIP foi iniciada em segundo plano
O nível de som pode ser verificado e monitorado tanto para fluxos de renderização quanto de captura. Os fluxos monitorados podem ser selecionados por categoria, ponto de extremidade de áudio ou função do dispositivo. O nível de som que um novo fluxo teria pode ser verificado antes que o fluxo seja criado. Essa API é equivalente à classe Windows.Media.Audio.AudiostateMonitor, que está disponível para aplicativos UWP, mas não para aplicativos da área de trabalho e jogos. Essa interface não pode ser usada por aplicativos UWP.

Membros

A interface IAudioStateMonitor herda da interface IUnknown, mas também tem estes tipos de membros:

Métodos

A interface IAudioStateMonitor tem estes métodos:

Comentários

Para obter uma instância dessa interface, chame um destes métodos: O código de exemplo a seguir demonstra o cenário em que um jogo se registra para receber notificações de nível de áudio para os fluxos de renderização de áudio na categoria AudioCategory_GameMedia. Se o nível de som dessa categoria estiver silenciado, o jogo interromperá a reprodução do fluxo de mídia do jogo. Se o nível de som estiver definido como qualquer outro valor, o fluxo de mídia do jogo será reproduzido.

Requisitos

Cabeçalho: Audiostatemonitorapi.h Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

Sobre o WASAPI
Last modified on October 6, 2026