midiInPrepareHeader-Funktion (mmeapi.h)

Die midiInPrepareHeader-Funktion bereitet einen Puffer für die MIDI-Eingabe vor.

Syntax

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

Parameter

hmi

Handle an das MIDI-Eingabegerät. Rufen Sie midiInOpen auf, um das Gerätehandle zu erhalten.

pmh

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

Legen Sie vor dem Aufrufen der Funktion die Elemente lpData, dwBufferLength und dwFlags der MIDIHDR-Struktur fest. Der dwFlags-Member muss auf 0 (null) festgelegt werden.

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
MMSYSERR_INVALHANDLE	Das angegebene Gerätehandle ist ungültig.
MMSYSERR_INVALPARAM	Die angegebene Adresse ist ungültig.
MMSYSERR_NOMEM	Das System kann Arbeitsspeicher nicht zuordnen oder sperren.

Hinweise

Bevor Sie einen MIDI-Datenblock an einen Gerätetreiber übergeben, müssen Sie den Puffer vorbereiten, indem Sie ihn an die Funktion midiInPrepareHeader übergeben. Nachdem der Header vorbereitet wurde, ändern Sie den Puffer nicht. Nachdem der Treiber den Puffer verwendet hat, rufen Sie die Funktion midiInUnprepareHeader auf.

Die Anwendung kann denselben Puffer erneut verwenden oder mehrere Puffer zuordnen und midiInPrepareHeader für jeden Puffer aufrufen. Wenn Sie denselben Puffer wiederverwenden, ist es nicht erforderlich, den Puffer jedes Mal vorzubereiten. Sie können midiInPrepareHeader einmal am Anfang und midiInUnprepareHeader einmal am Ende aufrufen.

Das Vorbereiten eines bereits vorbereiteten Headers hat keine Auswirkung, und die Funktion gibt null zurück.

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

Zuordnen und Vorbereiten von MIDI-Datenblöcken

MIDI-Funktionen

midiInUnprepareHeader