Freigeben über


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