IBasicAudio::get_Balance-Methode (control.h)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die get_Balance -Methode ruft den Saldo für das Audiosignal ab.

Syntax

HRESULT get_Balance(
  [out] long *plBalance
);

Parameter

[out] plBalance

Zeiger auf eine Variable, die den Saldo empfängt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode Beschreibung
E_NOTIMPL
 Das Filterdiagramm enthält keinen Audiorendererfilter. (Möglicherweise enthält die Quelle keinen Audiodatenstrom.)
E_POINTER
 NULL-Zeigerargument.
S_OK
 Erfolg.

Bemerkungen

Der Saldo reicht von -10.000 bis 10.000. Der Wert -10.000 bedeutet, dass der rechte Kanal um 100 dB abgeschwächt wird und effektiv stumm ist. Der Wert 10.000 bedeutet, dass der linke Kanal im Hintergrund ausgeführt wird. Der neutrale Wert ist 0. Dies bedeutet, dass beide Kanäle die volle Lautstärke aufweisen. Wenn ein Kanal abgeschwächt wird, bleibt der andere bei voller Lautstärke.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile control.h (include Dshow.h)
Bibliothek Strmiids.lib

Siehe auch

Fehler- und Erfolgscodes

IBasicAudio-Schnittstelle