Partager via


Interface IAudioSessionManager (audiopolicy.h)

L’interface IAudioSessionManager permet à un client d’accéder aux contrôles de session et aux contrôles de volume pour les sessions audio inter-processus et spécifiques aux processus. Le client obtient une référence à une interface IAudioSessionManager en appelant la méthode IMMDevice ::Activate avec le paramètre iid défini sur REFIID IID_IAudioSessionManager.

Cette interface permet aux clients d’accéder aux contrôles d’une session existante sans ouvrir au préalable un flux. Cette fonctionnalité est utile pour les clients d’API de niveau supérieur qui s’appuient sur WASAPI et utilisent des contrôles de session en interne, mais qui ne donnent pas à leurs clients l’accès aux contrôles de session.

Dans Windows Vista, les API de niveau supérieur qui utilisent WASAPI incluent Media Foundation, DirectSound, les fonctions multimédias Windows waveInXxx, waveOutXxx et mciXxx , ainsi que les API tierces.

Lorsqu’un client crée un flux audio via une API de niveau supérieur, cette API ajoute généralement le flux à la session audio par défaut pour le processus du client (la session identifiée par la valeur GUID de session, GUID_NULL), mais la même API peut ne pas fournir de moyen au client d’accéder aux contrôles de cette session. Dans ce cas, le client peut accéder aux contrôles via l’interface IAudioSessionManager .

Pour obtenir un exemple de code qui utilise l’interface IAudioSessionManager , consultez Événements audio pour les applications audio héritées.

Héritage

L’interface IAudioSessionManager hérite de l’interface IUnknown. IAudioSessionManager a également les types de membres suivants :

Méthodes

L’interface IAudioSessionManager a ces méthodes.

 
IAudioSessionManager ::GetAudioSessionControl

La méthode GetAudioSessionControl récupère un contrôle de session audio.
IAudioSessionManager ::GetSimpleAudioVolume

La méthode GetSimpleAudioVolume récupère un contrôle de volume audio simple.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête audiopolicy.h

Voir aussi

Interfaces audio principales

IMMDevice ::Activate

WASAPI