midiInUnprepareHeader-Funktion (mmeapi.h)
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 |
|---|---|
|
Der Puffer, auf den lpMidiInHdr verweist, befindet sich weiterhin in der Warteschlange. |
|
Der angegebene Zeiger oder die angegebene Struktur ist ungültig. |
|
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 |