midiOutPrepareHeader-Funktion (mmeapi.h)
Die midiOutPrepareHeader-Funktion bereitet einen midi-system exclusiven oder Streampuffer für die Ausgabe vor.
Syntax
MMRESULT midiOutPrepareHeader(
HMIDIOUT hmo,
LPMIDIHDR pmh,
UINT cbmh
);
Parameter
hmo
Handle zum MIDI-Ausgabegerät. Rufen Sie midiOutOpen auf, um das Gerätehandle zu erhalten. Dieser Parameter kann auch das Handle eines MIDI-Streams sein, der in einen HMDIOUT-Typ umgewandelt wird.
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, oder der angegebene Streampuffer ist größer als 64.000. |
|
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 MidiOutPrepareHeader-Funktion übergeben. Nachdem der Header vorbereitet wurde, ändern Sie den Puffer nicht. Nachdem der Treiber den Puffer verwendet hat, rufen Sie die Funktion midiOutUnprepareHeader auf.
Die Anwendung kann denselben Puffer wiederverwenden oder mehrere Puffer zuordnen und midiOutPrepareHeader für jeden Puffer aufrufen. Wenn Sie denselben Puffer wiederverwenden, ist es nicht erforderlich, den Puffer jedes Mal vorzubereiten. Sie können midiOutPrepareHeader einmal am Anfang und midiOutUnprepareHeader einmal am Ende aufrufen.
Ein Streampuffer darf nicht größer als 64 KB sein.
Das Vorbereiten eines bereits vorbereiteten Headers hat keine Auswirkung, und die Funktion gibt MMSYSERR_NOERROR zurück.
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 |