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 |
|---|---|
|
Parameter pfLevel ist NULL. |
|
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. |
|
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 |