Skip to main content

Méthode IAudioStateMonitor::RegisterCallback

Inscrit une fonction de rappel que le système appellera lorsque le niveau audio des flux associés à IAudioStateMonitor change.

Syntaxe

Paramètres

callback
Type : AudioStateMonitorCallback*
Pointeur vers la fonction de rappel appelée par le système lorsque le niveau audio des flux associés à IAudioStateMonitor change. context
Type : void*
Pointeur vers les données de contexte définies par l’application qui seront passées à la fonction spécifiée dans le paramètre callback. registration [out]
Type : AudioStateMonitorRegistration*
Entier 64 bits qui identifie l’inscription du rappel. Pour désinscrire la fonction spécifiée dans le paramètre callback, passez cette valeur à IAudioStateMonitor::UnregisterCallback.

Valeur de retour

Type : HRESULT Si la méthode réussit, elle retourne S_OK. Si elle échoue, les codes de retour possibles comprennent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Remarques

Considérez le scénario suivant, dans lequel un jeu choisit de lire de l’audio GameMedia uniquement lorsqu’il est connu que l’audio ne sera pas mis en sourdine par le système d’exploitation en raison d’une stratégie. Pour ce faire, le jeu s’inscrit aux notifications SoundLevel pour la catégorie de flux AudioCategory_GameMedia sur le point de terminaison de console par défaut. Si le SoundLevel de cette catégorie est réglé à ‘Muted’, le jeu arrêtera la lecture de son flux GameMedia. Si le SoundLevel est réglé à toute autre valeur, le jeu choisit de lire son flux GameMedia.

Configuration requise

En-tête : Audiostatemonitorapi.h Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

IAudioStateMonitor À propos de WASAPI
Last modified on October 6, 2026