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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | audiopolicy.h |