fonction midiOutUnprepareHeader (mmeapi.h)

Article
08/24/2023

La fonction midiOutUnprepareHeader nettoie la préparation effectuée par la fonction midiOutPrepareHeader .

Syntaxe

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

Paramètres

hmo

Gérez le périphérique de sortie MIDI. Ce paramètre peut également être le handle d’un flux MIDI casté en HMIDIOUT.

pmh

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

cbmh

Taille, en octets, 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 lpMidiOutHdr est toujours dans la file d’attente.
MMSYSERR_INVALHANDLE	Le handle d’appareil spécifié n’est pas valide.
MMSYSERR_INVALPARAM	Le pointeur ou la structure spécifiés n’est pas valide.

Notes

Cette fonction est complémentaire à la fonction midiOutPrepareHeader . Vous devez appeler midiOutUnprepareHeader avant de libérer la mémoire tampon. Après avoir passé une mémoire tampon au pilote de périphérique avec la fonction midiOutLongMsg , vous devez attendre que le pilote de périphérique soit terminé avec la mémoire tampon avant d’appeler midiOutUnprepareHeader.

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.

Spécifications


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

Partager via