waveOutGetVolume-Funktion (mmeapi.h)

Artikel
08/24/2023

Die waveOutGetVolume-Funktion ruft die aktuelle Lautstärke des angegebenen Waveform-Audioausgabegeräts ab.

Syntax

MMRESULT waveOutGetVolume(
  HWAVEOUT hwo,
  LPDWORD  pdwVolume
);

Parameter

hwo

Handle für ein offenes Waveform-Audioausgabegerät. Dieser Parameter kann auch ein Gerätebezeichner sein.

pdwVolume

Zeiger auf eine Variable, die mit der aktuellen Volumeeinstellung gefüllt werden soll. Das Wort mit niedriger Reihenfolge dieses Speicherorts enthält die Einstellung für das linke Kanalvolume, und das Wort mit hoher Reihenfolge enthält die Einstellung für den rechten Kanal. Ein Wert von 0xFFFF stellt das vollständige Volume dar, und ein Wert von 0x0000 ist Stille.

Wenn ein Gerät sowohl die linke als auch die rechte Lautstärkesteuerung nicht unterstützt, enthält das Wort mit niedriger Reihenfolge des angegebenen Speicherorts die Monovolumeebene.

Die vollständigen 16-Bit-Einstellungen, die mit der waveOutSetVolume-Funktion festgelegt sind, werden zurückgegeben, unabhängig davon, ob das Gerät die vollständigen 16 Bit der Steuerung auf Volumeebene unterstützt.

Rückgabewert

Gibt MMSYSERR_NOERROR zurück, wenn erfolgreich oder andernfalls ein Fehler aufgetreten ist. Mögliche Fehlerwerte sind:

Rückgabecode	Beschreibung
MMSYSERR_INVALHANDLE	Das angegebene Gerätehandle ist ungültig.
MMSYSERR_NODRIVER	Es ist kein Gerätetreiber vorhanden.
MMSYSERR_NOMEM	Speicher kann nicht zugeordnet oder gesperrt werden.
MMSYSERR_NOTSUPPORTED	Die Funktion wird nicht unterstützt.

Hinweise

Wenn ein Gerätebezeichner verwendet wird, gelten das Ergebnis des waveOutGetVolume-Aufrufs und die in pdwVolume zurückgegebenen Informationen für alle Instanzen des Geräts. Wenn ein Gerätehandle verwendet wird, gelten das zurückgegebene Ergebnis und die zurückgegebenen Informationen nur für die instance des Geräts, auf das vom Gerätehandle verwiesen wird.

Volumeänderungen werden nicht von allen Geräten unterstützt. Um zu bestimmen, ob das Gerät die Lautstärkesteuerung unterstützt, verwenden Sie das flag WAVECAPS_VOLUME, um das dwSupport-Element der WAVEOUTCAPS-Struktur zu testen (gefüllt mit der waveOutGetDevCaps-Funktion ).

Um zu bestimmen, ob das Gerät die Lautstärkeregelung für den linken und rechten Kanal unterstützt, verwenden Sie das WAVECAPS_LRVOLUME Flag, um das dwSupport-Element der WAVEOUTCAPS-Struktur zu testen (gefüllt mit waveOutGetDevCaps).

Volumeeinstellungen werden logarithmisch interpretiert. Dies bedeutet, dass der wahrgenommene Volumenanstieg gleich ist, wenn die Lautstärke von 0x5000 auf 0x6000 erhöht wird, wie von 0x4000 auf 0x5000.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mmeapi.h (einschließlich Windows.h)
Bibliothek	Winmm.lib
DLL	Winmm.dll

Weitere Informationen

Waveform Audio

Wellenformfunktionen