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 |
|---|---|
|
Das angegebene Gerätehandle ist ungültig. |
|
Die angegebene Adresse ist ungültig. |
|
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 |