auxGetVolume-Funktion (mmeapi.h)

  • Artikel

Die auxGetVolume-Funktion ruft die aktuelle Volumeeinstellung des angegebenen Hilfsausgabegeräts ab.

Syntax

MMRESULT auxGetVolume(
  UINT    uDeviceID,
  LPDWORD pdwVolume
);

Parameter

uDeviceID

Bezeichner des abgefragten Hilfsausgabegeräts.

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 richtige Kanaleinstellung. 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 Volumeebene.

Die vollständigen 16-Bit-Einstellungen, die mit der auxSetVolume-Funktion festgelegt sind, werden zurückgegeben, unabhängig davon, ob das Gerät die vollen 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_BADDEVICEID
 Der angegebene Gerätebezeichner liegt außerhalb des Bereichs.

Hinweise

Nicht alle Geräte unterstützen die Lautstärkeregelung. Um zu ermitteln, ob ein Gerät die Lautstärkesteuerung unterstützt, verwenden Sie das flag AUXCAPS_VOLUME, um das dwSupport-Element der AUXCAPS-Struktur zu testen (gefüllt mit der auxGetDevCaps-Funktion ).

Um zu bestimmen, ob ein Gerät die Lautstärkesteuerung sowohl auf dem linken als auch auf dem rechten Kanal unterstützt, verwenden Sie das flag AUXCAPS_LRVOLUME, um das dwSupport-Element der AUXCAPS-Struktur (gefüllt mit auxGetDevCaps) zu testen.

Anforderungen

Anforderung Wert
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