midiOutGetVolume-Funktion (mmeapi.h)

  • Artikel

Die midiOutGetVolume-Funktion ruft die aktuelle Lautstärkeeinstellung eines MIDI-Ausgabegeräts ab.

Syntax

MMRESULT midiOutGetVolume(
  HMIDIOUT hmo,
  LPDWORD  pdwVolume
);

Parameter

hmo

Handle für ein offenes MIDI-Ausgabegerät. Dieser Parameter kann auch das Handle eines MIDI-Streams enthalten, solange er in HMIDIOUT umgewandelt wird. Dieser Parameter kann auch ein Gerätebezeichner sein.

pdwVolume

Zeiger auf den Speicherort, der die aktuelle Volumeeinstellung enthält. Das Wort mit niedriger Reihenfolge dieser Position 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 die volle Lautstärke dar, und der Wert 0x0000 ist Stille.

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

Jeder Wert, der mithilfe der midiOutSetVolume-Funktion festgelegt wird, wird zurückgegeben, unabhängig davon, ob das Gerät diesen Wert 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_INVALPARAM
 Der angegebene Zeiger oder die angegebene Struktur ist ungültig.
MMSYSERR_NOMEM
 Das System kann Arbeitsspeicher nicht zuordnen oder sperren.
MMSYSERR_NOTSUPPORTED
 Die Funktion wird nicht unterstützt.

Hinweise

Wenn ein Gerätebezeichner verwendet wird, gelten das Ergebnis des midiOutGetVolume-Aufrufs und die in lpdwVolume 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.

Nicht alle Geräte unterstützen die Lautstärkeregelung. Sie können bestimmen, ob ein Gerät die Lautstärkesteuerung unterstützt, indem Sie das Gerät mithilfe der Funktion midiOutGetDevCaps abfragen und das flag MIDICAPS_VOLUME angeben.

Sie können auch bestimmen, ob das Gerät die Lautstärkesteuerung sowohl auf dem linken als auch im rechten Kanal unterstützt, indem Sie das Gerät mithilfe der MidiOutGetDevCaps-Funktion abfragen und das flag MIDICAPS_LRVOLUME angeben.

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ßen von Windows.h)
Bibliothek Winmm.lib
DLL Winmm.dll

Weitere Informationen

MIDI-Funktionen