Méthode IAudioSessionEvents ::OnGroupingParamChanged (audiopolicy.h)

La méthode OnGroupingParamChanged avertit le client que le paramètre de regroupement de la session a changé.

Syntaxe

HRESULT OnGroupingParamChanged(
  [in] LPCGUID NewGroupingParam,
  [in] LPCGUID EventContext
);

Paramètres

[in] NewGroupingParam

Nouveau paramètre de regroupement pour la session. Ce paramètre pointe vers un GUID de paramètre de regroupement.

[in] EventContext

Valeur de contexte d’événement. Il s’agit de la même valeur que celle que l’appelant a passée à IAudioSessionControl ::SetGroupingParam dans l’appel qui a modifié le paramètre de regroupement pour la session. Pour plus d'informations, consultez la section Notes.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.

Remarques

Le gestionnaire de session appelle cette méthode chaque fois qu’un appel à la méthode IAudioSessionControl ::SetGroupingParam modifie le paramètre de regroupement pour la session.

Le paramètre EventContext permet à un client de faire la distinction entre une modification de paramètre de regroupement qu’il a initiée et une modification initiée par un autre client. Lors de l’appel de la méthode IAudioSessionControl ::SetGroupingParam , un client transmet une valeur de paramètre EventContext que son implémentation de la méthode OnGroupingParamChanged peut reconnaître.

Pour obtenir un exemple de code qui implémente les méthodes dans l’interface IAudioSessionEvents , consultez Événements de session audio.

Configuration requise

Voir aussi

IAudioSessionControl ::SetGroupingParam

IAudioSessionEvents, interface