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
MMSYSERR_INVALHANDLE	Das angegebene Gerätehandle ist ungültig.
MMSYSERR_INVALPARAM	Die angegebene Adresse ist ungültig, oder der angegebene Streampuffer ist größer als 64.000.
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 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

Weitere Informationen

Zuordnen und Vorbereiten von MIDI-Datenblöcken

MIDI-Funktionen

midiOutUnprepareHeader