Méthode IMFPMediaPlayer ::SetVolume (mfplay.h)

  • Article
Important Déconseillée. Cette API peut être supprimée des versions ultérieures de Windows. Les applications doivent utiliser la session multimédia pour la lecture.
 

Définit le volume audio.

Syntaxe

HRESULT SetVolume(
  [in] float flVolume
);

Paramètres

[in] flVolume

Niveau de volume. 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).

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
 S_OK
MF_E_OUT_OF_RANGE
 Le paramètre flVolume n’est pas valide.

Remarques

Si vous appelez cette méthode avant le début de la lecture, le paramètre est appliqué après le démarrage de la lecture.

Cette méthode ne modifie pas le niveau de volume master pour la session audio du lecteur. Au lieu de cela, il ajuste les niveaux de volume par canal pour le ou les flux audio qui appartiennent à l’élément multimédia actuel. Les autres flux de la session audio ne sont pas affectés. Pour plus d’informations, consultez Gestion de la session audio.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mfplay.h

Voir aussi

IMFPMediaPlayer

Utilisation de MFPlay pour la lecture audio/vidéo