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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Der Audiorenderer wird nicht initialisiert. |
|
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 |