Méthode IAudioSessionManager2 ::GetSessionEnumerator (audiopolicy.h)

La méthode GetSessionEnumerator obtient un pointeur vers l’objet énumérateur de session audio.

Syntaxe

HRESULT GetSessionEnumerator(
  [out] IAudioSessionEnumerator **SessionEnum
);

Paramètres

[out] SessionEnum

Reçoit un pointeur vers l’interface IAudioSessionEnumerator de l’objet énumérateur de session que le client peut utiliser pour énumérer les sessions audio sur le périphérique audio. Grâce à cette méthode, l’appelant obtient une référence comptée à l’interface. L’appelant est chargé de libérer l’interface, lorsqu’elle n’est plus nécessaire, en appelant la méthode Release de l’interface.

Valeur retournée

Si la méthode réussit, retourne S_OK.

Remarques

Le gestionnaire de sessions gère une collection de sessions audio actives sur le périphérique audio en interrogeant le moteur audio. GetSessionEnumerator crée un contrôle de session pour chaque session de la collection. Pour obtenir une référence à l’interface IAudioSessionControl de la session dans la collection énumérée, l’application doit appeler IAudioSessionEnumerator ::GetSession. Pour obtenir un exemple de code, consultez Interface IAudioSessionEnumerator.

L’énumérateur de session peut ne pas connaître les nouvelles sessions signalées via IAudioSessionNotification. Par conséquent, si une application s’appuie exclusivement sur l’énumérateur de session pour obtenir toutes les sessions d’un point de terminaison audio, les résultats peuvent ne pas être exacts. Pour contourner ce problème, l’application doit gérer manuellement une liste. Pour plus d’informations, consultez IAudioSessionEnumerator.

Configuration requise

Voir aussi

IAudioSessionManager2