IMFSimpleAudioVolume::SetMasterVolume-Methode (mfidl.h)

Legt die master Lautstärkeebene fest.

Syntax

HRESULT SetMasterVolume(
  [in] float fLevel
);

Parameter

[in] fLevel

Lautstärke. 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_NOT_INITIALIZED	Der Audiorenderer wird nicht initialisiert.
MF_E_STREAMSINK_REMOVED	Der Audiorenderer wurde aus der Pipeline entfernt.

Hinweise

Ereignisse außerhalb der Anwendung können die master Volumeebene ändern. Beispielsweise kann der Benutzer die Lautstärke über das Systemvolumesteuerungsprogramm (SndVol) ändern. Wenn ein externes Ereignis die master Volume ändert, sendet der Audiorenderer ein MEAudioSessionVolumeChanged-Ereignis, das die Mediensitzung an die Anwendung weiterleitet.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfidl.h
Bibliothek	Mfuuid.lib

Weitere Informationen

IMFSimpleAudioVolume

Streaming-Audiorenderer