Interface IAudioSessionControl (audiopolicy.h)

L’interface IAudioSessionControl permet à un client de configurer les paramètres de contrôle d’une session audio et de surveiller les événements de la session. La méthode IAudioClient ::Initialize initialise un objet stream et affecte le flux à une session audio. Le client obtient une référence à l’interface IAudioSessionControl sur un objet de flux en appelant la méthode IAudioClient ::GetService avec un riid de paramètre défini sur REFIID IID_IAudioSessionControl.

Un client peut également obtenir l’interface IAudioSessionControl d’une session existante sans avoir à créer d’abord un objet de flux et à ajouter le flux à la session. Au lieu de cela, le client appelle la méthode IAudioSessionManager ::GetAudioSessionControl avec le paramètre AudioSessionGuid défini sur le GUID de session.

Le client peut s’inscrire pour recevoir une notification du gestionnaire de sessions lorsque les clients modifient les paramètres de session via les méthodes de l’interface IAudioSessionControl .

Lors de la libération d’une interface IAudioSessionControl instance, le client doit appeler la méthode Release de l’interface à partir du même thread que l’appel à IAudioClient ::GetService qui a créé l’objet.

L’interface IAudioSessionControl contrôle une session audio. Une session audio est une collection de flux en mode partagé. Cette interface ne fonctionne pas avec les flux en mode exclusif.

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

Héritage

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

Méthodes

L’interface IAudioSessionControl a ces méthodes.

IAudioSessionControl ::GetDisplayName La méthode GetDisplayName récupère le nom d’affichage de la session audio.
IAudioSessionControl ::GetGroupingParam La méthode GetGroupingParam récupère le paramètre de regroupement de la session audio.
IAudioSessionControl ::GetIconPath La méthode GetIconPath récupère le chemin d’accès de l’icône d’affichage pour la session audio.
IAudioSessionControl ::GetState La méthode GetState récupère l’état actuel de la session audio.
IAudioSessionControl ::RegisterAudioSessionNotification La méthode RegisterAudioSessionNotification inscrit le client pour recevoir des notifications d’événements de session, y compris les modifications de l’état du flux.
IAudioSessionControl ::SetDisplayName La méthode SetDisplayName attribue un nom d’affichage à la session active.
IAudioSessionControl ::SetGroupingParam La méthode SetGroupingParam affecte une session à un regroupement de sessions.
IAudioSessionControl ::SetIconPath La méthode SetIconPath affecte une icône d’affichage à la session active.
IAudioSessionControl ::UnregisterAudioSessionNotification La méthode UnregisterAudioSessionNotification supprime une inscription précédente par le client pour recevoir des notifications.

Configuration requise

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

Voir aussi

Interfaces audio principales

IAudioClient ::GetService

IAudioClient ::Initialize

IAudioSessionManager ::GetAudioSessionControl

WASAPI