Méthode IAudioSessionControl ::GetGroupingParam (audiopolicy.h)
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 |
|---|---|
|
Le paramètre pRetVal est NULL. |
|
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. |
|
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 |