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

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