Partager via


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