midiOutUnprepareHeader-Funktion (mmeapi.h)

  • Artikel

Die midiOutUnprepareHeader-Funktion bereinigt die Vorbereitung, die von der midiOutPrepareHeader-Funktion durchgeführt wird.

Syntax

MMRESULT midiOutUnprepareHeader(
  HMIDIOUT  hmo,
  LPMIDIHDR pmh,
  UINT      cbmh
);

Parameter

hmo

Handle mit dem MIDI-Ausgabegerät. Dieser Parameter kann auch der Handle eines MIDI-Streams sein, der in HMIDIOUT umgewandelt wird.

pmh

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

cbmh

Größe der MIDIHDR-Struktur in Bytes.

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 lpMidiOutHdr verweist, befindet sich weiterhin in der Warteschlange.
MMSYSERR_INVALHANDLE
 Das angegebene Gerätehandle ist ungültig.
MMSYSERR_INVALPARAM
 Der angegebene Zeiger oder die angegebene Struktur ist ungültig.

Hinweise

Diese Funktion ergänzt die midiOutPrepareHeader-Funktion . Sie müssen midiOutUnprepareHeader aufrufen, bevor Sie den Puffer freigeben. Nachdem Sie einen Puffer mit der Funktion midiOutLongMsg an den Gerätetreiber übergeben haben, müssen Sie warten, bis der Gerätetreiber mit dem Puffer fertig ist, bevor Sie midiOutUnprepareHeader aufrufen.

Das Aufheben der Vorbereitung eines Puffers, der nicht vorbereitet wurde, hat keine Auswirkungen, 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ßlich Windows.h)
Bibliothek Winmm.lib
DLL Winmm.dll

Weitere Informationen

Zuweisung und Vorbereiten von MIDI-Datenblöcken

MIDI-Funktionen