Skip to main content

Método IAudioStateMonitor::GetSoundLevel

[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.] Obtém o nível de som atual dos fluxos associados a IAudioStateMonitor.

Sintaxe

Parâmetros

Este método não tem parâmetros.

Valor de retorno

Um valor da enumeração AudioStateMonitorSoundLevel que indica o nível de som atual dos fluxos associados ao IAudioStateMonitor.

Comentários

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 conseguir 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.
Um valor da enumeração AudioStateMonitorSoundLevel. Indica o nível de som atual dos fluxos associados a IAudioStateMonitor.

Requisitos

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

Confira também

IAudioStateMonitor Sobre o WASAPI
Last modified on October 6, 2026