midiOutUnprepareHeader-Funktion (mmeapi.h)
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 |
|---|---|
|
Der Puffer, auf den lpMidiOutHdr verweist, befindet sich weiterhin in der Warteschlange. |
|
Das angegebene Gerätehandle ist ungültig. |
|
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 |