IAudioEndpointVolume::GetMasterVolumeLevel-Methode (endpointvolume.h)

Die GetMasterVolumeLevel-Methode ruft den master Lautstärkepegel des Audiodatenstroms in Dezibel ab, der in das Audioendpunktgerät eingeht oder dieses verlässt.

Syntax

HRESULT GetMasterVolumeLevel(
  [out] float *pfLevelDB
);

Parameter

[out] pfLevelDB

Zeiger auf die master Volumeebene. Dieser Parameter verweist auf eine float-Variable , in die die -Methode die Lautstärkeebene in Dezibel schreibt. Rufen Sie die IAudioEndpointVolume::GetVolumeRange-Methode auf, um den Bereich der Volumeebenen abzurufen, die von dieser Methode abgerufen werden.

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_POINTER	Der Parameter pfLevelDB ist NULL.

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

IAudioEndpointVolume::GetVolumeRange