midiInUnprepareHeader-Funktion (mmeapi.h)

  • Artikel

Die Funktion midiInUnprepareHeader bereinigt die Vorbereitung, die von der midiInPrepareHeader-Funktion durchgeführt wird.

Syntax

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

Parameter

hmi

Handle an das MIDI-Eingabegerät.

pmh

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

cbmh

Größe der MIDIHDR-Struktur .

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.
MMSYSERR_INVALPARAM
 Der angegebene Zeiger oder die angegebene Struktur ist ungültig.
MMSYSERR_INVALHANDLE
 Das angegebene Gerätehandle ist ungültig.

Hinweise

Diese Funktion ergänzt midiInPrepareHeader. Sie müssen diese Funktion verwenden, bevor Sie den Puffer freigeben. Nachdem Sie mithilfe der MidiInAddBuffer-Funktion einen Puffer an den Gerätetreiber übergeben haben, müssen Sie warten, bis der Treiber mit dem Puffer fertig ist, bevor Sie midiInUnprepareHeader verwenden. Das Aufheben der Vorbereitung eines Puffers, der nicht vorbereitet wurde, hat keine Auswirkung, und die Funktion gibt MMSYSERR_NOERROR 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