Méthode IBasicAudio::get_Balance (control.h)

Article
07/28/2023

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La get_Balance méthode récupère l’équilibre du signal audio.

Syntaxe

HRESULT get_Balance(
  [out] long *plBalance
);

Paramètres

[out] plBalance

Pointeur vers une variable qui reçoit le solde.

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour	Description
E_NOTIMPL	Le graphe de filtre ne contient pas de filtre de convertisseur audio. (La source ne contient peut-être pas de flux audio.)
E_POINTER	Argument pointeur NULL .
S_OK	Opération réussie.

Notes

Le solde varie de -10 000 à 10 000. La valeur -10 000 signifie que le canal droit est atténué de 100 dB et est effectivement silencieux. La valeur 10 000 signifie que le canal de gauche est silencieux. La valeur neutre est 0, ce qui signifie que les deux canaux sont à plein volume. Lorsqu’un canal est atténué, l’autre reste à plein volume.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	control.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IBasicAudio Interface

Share via