Méthode IPerChannelDbLevel ::GetLevelRange (devicetopology.h)

Article
02/26/2024

La méthode GetLevelRange obtient la plage, en décibels, du niveau de volume du canal spécifié.

Syntaxe

HRESULT GetLevelRange(
  [in]  UINT  nChannel,
  [out] float *pfMinLevelDB,
  [out] float *pfMaxLevelDB,
  [out] float *pfStepping
);

Paramètres

[in] nChannel

Numéro du canal sélectionné. Si le flux audio a n canaux, les canaux sont numérotés de 0 à n– 1. Pour obtenir le nombre de canaux dans le flux, appelez la méthode IPerChannelDbLevel ::GetChannelCount .

[out] pfMinLevelDB

Pointeur vers une variable float dans laquelle la méthode écrit le niveau de volume minimal en décibels.

[out] pfMaxLevelDB

Pointeur vers une variable float dans laquelle la méthode écrit le niveau de volume maximal en décibels.

[out] pfStepping

Pointeur vers une variable float dans laquelle la méthode écrit la valeur pas à pas entre des niveaux de volume consécutifs dans la plage *pfMinLevelDB vers *pfMaxLevelDB. Si la différence entre les niveaux de volume maximal et minimal est d décibels et que la plage est divisée en n étapes (intervalles uniformément dimensionnés), le volume peut avoir n + 1 niveaux discrets et la taille de l’étape entre les niveaux consécutifs est d / n décibels.

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_INVALIDARG	Le paramètre nChannel est hors plage.
E_POINTER	Le pointeur pfminLevelDB, pfmaxLevelDB ou pfmaxLevelDB a la valeur NULL.

Configuration requise

Condition requise	Valeur
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	devicetopology.h

Voir aussi

IPerChannelDbLevel, interface

IPerChannelDbLevel ::GetChannelCount

Partager via