Interface IMFAudioStreamVolume (mfidl.h)

  • Article

Contrôle les niveaux de volume des canaux audio individuels.

Le convertisseur audio de streaming (SAR) expose cette interface en tant que service. Pour obtenir un pointeur vers l’interface, appelez IMFGetService::GetService avec l’identificateur de service MR_STREAM_VOLUME_SERVICE. Vous pouvez appeler GetService directement sur le sar ou l’appeler sur la session multimédia.

Héritage

L’interface IMFAudioStreamVolume hérite de l’interface IUnknown . IMFAudioStreamVolume a également les types de membres suivants :

Méthodes

L’interface IMFAudioStreamVolume utilise ces méthodes.

 
IMFAudioStreamVolume::GetAllVolumes

Récupère les niveaux de volume pour tous les canaux du flux audio.
IMFAudioStreamVolume::GetChannelCount

Récupère le nombre de canaux dans le flux audio.
IMFAudioStreamVolume::GetChannelVolume

Récupère le niveau de volume d’un canal spécifié dans le flux audio.
IMFAudioStreamVolume::SetAllVolumes

Définit les niveaux de volume individuels pour tous les canaux du flux audio.
IMFAudioStreamVolume::SetChannelVolume

Définit le niveau de volume d’un canal spécifié dans le flux audio.

Notes

Si votre application ne nécessite pas de contrôle du volume au niveau du canal, vous pouvez utiliser l’interface IMFSimpleAudioVolume pour contrôler le niveau de volume master de la session audio.

Le volume est exprimé sous la forme d’un niveau d’atténuation, où 0,0 indique le silence et 1.0 indique le volume complet (aucune atténuation). Pour chaque canal, le niveau d’atténuation est le produit de :

  • Niveau de volume master de la session audio.
  • Niveau de volume du canal.
Par exemple, si le volume master est 0,8 et le volume de canal est 0,5, l’atténuation de ce canal est de 0,8 × 0,5 = 0,4. Les niveaux de volume peuvent dépasser 1,0 (gain positif), mais le moteur audio extrait tous les échantillons audio qui dépassent zéro décibels.

Utilisez la formule suivante pour convertir le niveau de volume en décibels (dB) :

Atténuation (dB) = 20 * log10(Level)

Par exemple, un niveau de volume de 0,50 représente 6,02 dB d’atténuation.

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 mfidl.h

Voir aussi

Interfaces Media Foundation

Convertisseur audio de streaming