Interface IMFSimpleAudioVolume (mfidl.h)

  • Article

Contrôle le niveau de volume master de la session audio associée au convertisseur audio en continu (SAR) et à la source de capture audio.

Le SAR et la source de capture audio exposent cette interface en tant que service. Pour obtenir un pointeur vers l’interface, appelez IMFGetService::GetService. Pour le sar, utilisez l’identificateur de service MR_POLICY_VOLUME_SERVICE. Pour la source de capture audio, utilisez l’identificateur de service MR_CAPTURE_POLICY_VOLUME_SERVICE. Vous pouvez appeler GetService directement sur le sar ou la source de capture audio, ou l’appeler sur la session multimédia.

Héritage

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

Méthodes

L’interface IMFSimpleAudioVolume a ces méthodes.

 
IMFSimpleAudioVolume::GetMasterVolume

Récupère le niveau de volume master.
IMFSimpleAudioVolume::GetMute

Demande si l’audio est désactivé. (IMFSimpleAudioVolume.GetMute)
IMFSimpleAudioVolume::SetMasterVolume

Définit le niveau de volume master.
IMFSimpleAudioVolume::SetMute

Désactive ou désactive l’audio. (IMFSimpleAudioVolume.SetMute)

Notes

Pour contrôler les niveaux de volume des canaux individuels, utilisez l’interface IMFAudioStreamVolume . L’interface IMFAudioStreamVolume est prise en charge uniquement par le SAR.

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 :

  • Le master niveau de volume 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 les échantillons audio qui dépassent zéro décibels. Pour modifier le niveau de volume des canaux individuels, utilisez l’interface IMFAudioStreamVolume .

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.

Spécifications

   
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