Méthode IBasicAudio ::p ut_Balance (control.h)

  • Article

[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 put_Balance méthode définit l’équilibre du signal audio.

Syntaxe

HRESULT put_Balance(
  [in] long lBalance
);

Paramètres

[in] lBalance

Spécifie le solde. La valeur peut varier 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.

Valeur retournée

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

Code de retour Description
E_FAIL
 Le périphérique audio sous-jacent a renvoyé une erreur.
E_INVALIDARG
 La valeur de lBalance n’est pas valide.
E_NOTIMPL
 Le graphe de filtre ne contient pas de filtre de convertisseur audio. (La source ne contient peut-être pas de flux audio.)
S_OK
 Réussite.

Configuration requise

Condition requise Valeur
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