Skip to main content

Método IAudioStateMonitor::RegisterCallback

Registra uma função de retorno de chamada que o sistema chamará quando o nível de áudio dos fluxos associados ao IAudioStateMonitor mudar.

Sintaxe

Parâmetros

callback
Tipo: AudioStateMonitorCallback*
Um ponteiro para a função de retorno de chamada que é chamada pelo sistema quando há uma alteração no nível de áudio dos fluxos associados a IAudioStateMonitor. context
Tipo: void*
Um ponteiro para os dados de contexto definidos pelo aplicativo que serão passados para a função especificada no parâmetro callback. registration [out]
Tipo: AudioStateMonitorRegistration*
Um inteiro de 64 bits que identifica o registro do retorno de chamada. Para cancelar o registro da função especificada no parâmetro callback, passe esse valor para IAudioStateMonitor::UnregisterCallback.

Valor de retorno

Tipo: HRESULT Se o método for bem-sucedido, ele retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, entre outros, os valores mostrados na tabela a seguir.

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.

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