Skip to main content

Método IAudioStateMonitor::RegisterCallback

Registra una función de devolución de llamada a la que el sistema llamará cuando cambie el nivel de audio de las secuencias asociadas a IAudioStateMonitor.

Sintaxis

Parámetros

callback
Tipo: AudioStateMonitorCallback*
Un puntero a la función de devolución de llamada a la que el sistema llama cuando hay un cambio en el nivel de audio de las secuencias asociadas a IAudioStateMonitor. context
Tipo: void*
Un puntero a los datos de contexto definidos por la aplicación que se pasarán a la función especificada en el parámetro callback. registration [out]
Tipo: AudioStateMonitorRegistration*
Un entero de 64 bits que identifica el registro de la devolución de llamada. Para anular el registro de la función especificada en el parámetro callback, pase este valor a IAudioStateMonitor::UnregisterCallback.

Valor devuelto

Tipo: HRESULT Si el método se ejecuta correctamente, devuelve S_OK. Si se produce un error, los códigos devueltos posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Comentarios

Considere el siguiente escenario, en el que un juego elige reproducir audio GameMedia solo cuando se sabe que el sistema operativo no silenciará el audio debido a la directiva. Para lograrlo, el juego se registra para recibir notificaciones de SoundLevel de la categoría de secuencia AudioCategory_GameMedia en el punto de conexión de consola predeterminado. Si el SoundLevel de esta categoría se establece en ‘Muted’, el juego detendrá la reproducción de su secuencia GameMedia. Si el SoundLevel se establece en cualquier otro valor, el juego elige reproducir su secuencia GameMedia.

Requisitos

Encabezado: Audiostatemonitorapi.h Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

IAudioStateMonitor Acerca de WASAPI
Última modificación el 28 de agosto de 2026