midiInAddBuffer-Funktion (mmeapi.h)

  • Artikel

Die midiInAddBuffer-Funktion sendet einen Eingabepuffer an ein angegebenes geöffnetes MIDI-Eingabegerät. Diese Funktion wird für system exklusive Nachrichten verwendet.

Syntax

MMRESULT midiInAddBuffer(
  HMIDIIN   hmi,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Parameter

hmi

Handle an das MIDI-Eingabegerät.

pmh

Zeiger auf eine MIDIHDR-Struktur , die den Puffer identifiziert.

cbmh

Größe der MIDIHDR-Struktur in Byte.

Rückgabewert

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

Rückgabecode Beschreibung
MIDIERR_STILLPLAYING
 Der Puffer, auf den lpMidiInHdr verweist, befindet sich weiterhin in der Warteschlange.
MIDIERR_UNPREPARED
 Der Puffer, auf den lpMidiInHdr verweist, wurde nicht vorbereitet.
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.

Hinweise

Wenn der Puffer gefüllt ist, wird er an die Anwendung zurückgesendet.

Der Puffer muss mithilfe der MidiInPrepareHeader-Funktion vorbereitet werden, bevor er an die midiInAddBuffer-Funktion übergeben wird.

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

Weitere Informationen

MIDI-Funktionen