IAudioEndpointVolume::SetMasterVolumeLevelScalar-Methode (endpointvolume.h)

Die SetMasterVolumeLevelScalar-Methode legt die master Lautstärke des Audiodatenstroms fest, der in das Audioendpunktgerät eintritt oder dieses verlässt. Der Lautstärkepegel wird als normalisierter Audiowert im Bereich von 0,0 bis 1,0 ausgedrückt.

Syntax

HRESULT SetMasterVolumeLevelScalar(
  [in] float   fLevel,
  [in] LPCGUID pguidEventContext
);

Parameter

[in] fLevel

Die neue master Lautstärkeebene. Die Ebene wird als normalisierter Wert im Bereich von 0,0 bis 1,0 ausgedrückt.

[in] pguidEventContext

Kontextwert für die IAudioEndpointVolumeCallback::OnNotify-Methode . Dieser Parameter verweist auf eine Ereigniskontext-GUID. Wenn der SetMasterVolumeLevelScalar-Aufruf die Volumeebene des Endpunkts ändert, erhalten alle Clients, die IAudioEndpointVolumeCallback registriert haben, Benachrichtigungen. Bei der Implementierung der OnNotify-Methode kann ein Client die Ereigniskontext-GUID untersuchen, um zu ermitteln, ob sie oder ein anderer Client die Quelle des Volumeänderungsereignisses ist. Wenn der Aufrufer einen NULL-Zeiger für diesen Parameter bereitstellt, empfängt die Benachrichtigungsroutine den Kontext-GUID-Wert GUID_NULL.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
E_INVALIDARG	Der Parameter fLevel liegt außerhalb des Bereichs von 0,0 bis 1,0.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Hinweise

Die Lautstärke wird auf den Bereich von 0,0 bis 1,0 normalisiert, wobei 0,0 die minimale Lautstärke und 1,0 die maximale Lautstärke ist. Innerhalb dieses Bereichs wird die Beziehung des normalisierten Lautstärkepegels zur Dämpfung der Signalamplitude durch eine nicht lineare, audioverkippte Kurve beschrieben. Beachten Sie, dass sich die Form der Kurve in zukünftigen Versionen von Windows ändern kann. Weitere Informationen zu audioverknippten Kurven finden Sie unter Audio-Lautstärkesteuerungen.

Die normalisierten Lautstärken, die an diese Methode übergeben werden, eignen sich für die Darstellung der Positionen von Lautstärkereglern in Anwendungsfenstern und Bildschirmanzeigen.

Ein Codebeispiel, das SetMasterVolumeLevelScalar aufruft, finden Sie unter Endpunktvolumesteuerungen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	endpointvolume.h

Weitere Informationen

IAudioEndpointVolume-Schnittstelle

IAudioEndpointVolumeCallback-Schnittstelle

IAudioEndpointVolumeCallback::OnNotify