IMFPMediaPlayer::SetBalance-Methode (mfplay.h)

Wichtig Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden. Anwendungen sollten die Mediensitzung für die Wiedergabe verwenden.
 

Legt die Audiobalance fest.

Syntax

HRESULT SetBalance(
  [in] float flBalance
);

Parameter

[in] flBalance

Die Audiobalance. Der Wert kann eine beliebige Zahl im folgenden Bereich (einschließlich) sein.

Wert Bedeutung
-1.0
Der linke Kanal hat die volle Lautstärke; der richtige Kanal ist unbeaufsichtigt.
+1.0
Der richtige Kanal hat die volle Lautstärke; der linke Kanal ist unbeaufsichtigt.
 

Wenn der Wert 0 ist, sind der linke und der rechte Kanal gleich groß. Der Standardwert ist 0 (null).

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode Beschreibung
S_OK
Die Methode wurde erfolgreich ausgeführt.
MF_E_OUT_OF_RANGE
Der flBalance-Parameter ist ungültig.

Hinweise

Wenn Sie diese Methode aufrufen, bevor die Wiedergabe beginnt, wird die Einstellung angewendet, wenn die Wiedergabe beginnt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfplay.h

Weitere Informationen

IMFPMediaPlayer

Verwenden von MFPlay für die Audio-/Videowiedergabe