IAudioEndpointVolume::GetMasterVolumeLevelScalar-Methode (endpointvolume.h)
Die GetMasterVolumeLevelScalar-Methode ruft die master Lautstärkeebene des Audiodatenstroms ab, 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 GetMasterVolumeLevelScalar(
[out] float *pfLevel
);
Parameter
[out] pfLevel
Zeiger auf die master Volumeebene. Dieser Parameter verweist auf eine float-Variable , in die die -Methode die Volumeebene schreibt. Die Ebene wird als normalisierter Wert im Bereich von 0,0 bis 1,0 ausgedrückt.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Parameter pfLevel ist NULL. |
Hinweise
Die Volumeebene wird auf den Bereich von 0,0 bis 1,0 normalisiert, wobei 0,0 die minimale Lautstärke und 1,0 der maximale Pegel ist. Innerhalb dieses Bereichs wird die Beziehung des normalisierten Lautstärkepegels zur Dämpfung der Signalamplitude durch eine nichtlineare, audioverkippte Kurve beschrieben. Beachten Sie, dass sich die Form der Kurve in zukünftigen Versionen von Windows ändern kann. Weitere Informationen zu Audioverknüngungskurven finden Sie unter Audioverknen von Lautstärkesteuerungen.
Die von dieser Methode abgerufenen normalisierten Lautstärkeebenen eignen sich zur Darstellung der Positionen von Lautstärkereglern in Anwendungsfenstern und Bildschirmanzeigen.
Ein Codebeispiel, das GetMasterVolumeLevelScalar aufruft, finden Sie unter Endpunktvolumesteuerelemente.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |