IMFPMediaPlayer::SetVolume-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 Audiolautstärke fest.

Syntax

HRESULT SetVolume(
  [in] float flVolume
);

Parameter

[in] flVolume

Die Volumeebene. Das Volumen wird als Dämpfungsstufe ausgedrückt, wobei 0,0 für Stille und 1,0 für volle Lautstärke (keine Dämpfung) steht.

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 flVolume-Parameter ist ungültig.

Hinweise

Wenn Sie diese Methode aufrufen, bevor die Wiedergabe beginnt, wird die Einstellung nach dem Start der Wiedergabe angewendet.

Diese Methode ändert nicht den master Lautstärkepegel für die Audiositzung des Players. Stattdessen werden die Lautstärkepegel pro Kanal für Audiodatenströme angepasst, die zum aktuellen Medienelement gehören. Andere Streams in der Audiositzung sind nicht betroffen. Weitere Informationen finden Sie unter Verwalten der Audiositzung.

Anforderungen

Anforderung	Wert
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