ISimpleAudioVolume::GetMasterVolume-Methode (audioclient.h)

Die GetMasterVolume-Methode ruft die Clientlautstärke für die Audiositzung ab.

Syntax

HRESULT GetMasterVolume(
  [out] float *pfLevel
);

Parameter

[out] pfLevel

Zeiger auf eine float-Variable , in die die Methode die Clientvolumeebene schreibt. Die Volumeebene ist ein Wert im Bereich von 0,0 bis 1,0.

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	Parameter pfLevel ist NULL.
AUDCLNT_E_DEVICE_INVALIDATED	Das Audioendpunktgerät wurde nicht angeschlossen, oder die Audiohardware oder die zugehörigen Hardwareressourcen wurden neu konfiguriert, deaktiviert, entfernt oder anderweitig nicht mehr verfügbar gemacht.
AUDCLNT_E_SERVICE_NOT_RUNNING	Der Windows-Audiodienst wird nicht ausgeführt.

Hinweise

Diese Methode ruft die Clientvolumeebene für die Sitzung ab. Dies ist die Volumeebene, die der Client in einem vorherigen Aufruf der ISimpleAudioVolume::SetMasterVolume-Methode festgelegt hat .

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	audioclient.h

Weitere Informationen

IAudioClient::Initialize

ISimpleAudioVolume-Schnittstelle

ISimpleAudioVolume::SetMasterVolume