midiInAddBuffer-Funktion (mmeapi.h)

Artikel
08/24/2023

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

Freigeben über