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 |
|---|---|
|
Der Parameter fLevel liegt außerhalb des Bereichs von 0,0 bis 1,0. |
|
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