Freigeben über


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
E_POINTER
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

Weitere Informationen

IAudioEndpointVolume-Schnittstelle