Share via

Méthode IAudioSessionControl ::GetGroupingParam (audiopolicy.h)

  • Article

La méthode GetGroupingParam récupère le paramètre de regroupement de la session audio.

Syntaxe

HRESULT GetGroupingParam(
  [out] GUID *pRetVal
);

Paramètres

[out] pRetVal

Pointeur de sortie pour le GUID grouping-parameter. Ce paramètre doit être un pointeur valide et non NULL vers une variable GUID allouée par l’appelant. La méthode écrit le paramètre de regroupement dans cette variable.

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
E_POINTER
 Le paramètre pRetVal est NULL.
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.

Remarques

Toutes les sessions audio qui ont la même valeur de paramètre de regroupement sont sous le contrôle du même curseur de niveau volume dans le programme système de contrôle de volume, Sndvol. Pour plus d’informations, consultez Paramètres de regroupement.

Un client peut appeler la méthode IAudioSessionControl ::SetGroupingParam pour modifier le paramètre de regroupement d’une session.

Si un client n’a jamais appelé SetGroupingParam pour affecter un paramètre de regroupement à une session audio, la valeur du paramètre de regroupement de la session est GUID_NULL par défaut et un appel à GetGroupingParam récupère cette valeur. Une valeur de paramètre de regroupement de GUID_NULL indique que la session n’appartient à aucun regroupement. Dans ce cas, la session a son propre curseur au niveau du volume dans le programme Sndvol.

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

IAudioSessionControl, interface

IAudioSessionControl ::SetGroupingParam