Méthode IAudioSessionManager::GetAudioSessionControl (audiopolicy.h)

Article
08/22/2023

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

Syntaxe

HRESULT GetAudioSessionControl(
  [in]  LPCGUID              AudioSessionGuid,
  [in]  DWORD                StreamFlags,
  [out] IAudioSessionControl **SessionControl
);

Paramètres

[in] AudioSessionGuid

Pointeur vers un GUID de session. Si le GUID n’identifie pas une session qui a été précédemment ouverte, l’appel ouvre une nouvelle session vide. Le programme Sndvol n’affiche pas de contrôle au niveau du volume pour une session, sauf s’il contient un ou plusieurs flux actifs. Si ce paramètre a la valeur NULL ou pointe vers la valeur GUID_NULL, la méthode affecte le flux à la session par défaut.

[in] StreamFlags

Spécifie la status des indicateurs pour le flux audio.

[out] SessionControl

Pointeur vers une variable pointeur dans laquelle la méthode écrit un pointeur vers l’interface IAudioSessionControl de l’objet de contrôle de session audio. L’appelant est chargé de libérer l’interface, quand elle n’est plus nécessaire, en appelant la méthode Release de l’interface. Si l’appel échoue, *SessionControl a la valeur NULL.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour	Description
AUDCLNT_E_NOT_INITIALIZED	Le flux audio n’a pas été correctement initialisé.
AUDCLNT_E_DEVICE_INVALIDATED	Le périphérique de point de terminaison audio a été débranché, ou le matériel audio ou les ressources matérielles associées ont été reconfigurés, désactivés, supprimés ou autrement rendus indisponibles.
AUDCLNT_E_SERVICE_NOT_RUNNING	Le service audio Windows n’est pas en cours d’exécution.
E_POINTER	Le paramètre SessionControl a la valeur NULL.
E_MEMORY	Mémoire insuffisante.

Remarques

Pour obtenir un exemple de code qui appelle cette méthode, consultez Événements audio pour les applications audio héritées.

Configuration requise


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

IAudioSessionControl, interface

IAudioSessionManager, interface

Partager via