Partager via


fonction midiInUnprepareHeader (mmeapi.h)

La fonction midiInUnprepareHeader nettoie la préparation effectuée par la fonction midiInPrepareHeader .

Syntaxe

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

Paramètres

hmi

Gérez le périphérique d’entrée MIDI.

pmh

Pointeur vers une structure MIDIHDR identifiant la mémoire tampon à nettoyer.

cbmh

Taille de la structure MIDIHDR .

Valeur retournée

Retourne MMSYSERR_NOERROR en cas de réussite ou une erreur dans le cas contraire. Les valeurs d’erreur possibles sont les suivantes.

Code de retour Description
MIDIERR_STILLPLAYING
La mémoire tampon pointée vers lpMidiInHdr est toujours dans la file d’attente.
MMSYSERR_INVALPARAM
Le pointeur ou la structure spécifiés n’est pas valide.
MMSYSERR_INVALHANDLE
Le handle d’appareil spécifié n’est pas valide.

Notes

Cette fonction est complémentaire à midiInPrepareHeader. Vous devez utiliser cette fonction avant de libérer la mémoire tampon. Après avoir passé une mémoire tampon au pilote de périphérique à l’aide de la fonction midiInAddBuffer , vous devez attendre que le pilote soit terminé avec la mémoire tampon avant d’utiliser midiInUnprepareHeader. Le fait de ne pas préparer une mémoire tampon qui n’a pas été préparée n’a aucun effet et la fonction retourne MMSYSERR_NOERROR.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête mmeapi.h (inclure Windows.h)
Bibliothèque Winmm.lib
DLL Winmm.dll

Voir aussi

Allocation et préparation des blocs de données MIDI

Fonctions MIDI