fonction waveInUnprepareHeader (mmeapi.h)
La fonction waveInUnprepareHeader nettoie la préparation effectuée par la fonction waveInPrepareHeader . Cette fonction doit être appelée une fois que le pilote de périphérique a rempli une mémoire tampon et l’a renvoyée à l’application. Vous devez appeler cette fonction avant de libérer la mémoire tampon.
Syntaxe
MMRESULT waveInUnprepareHeader(
HWAVEIN hwi,
LPWAVEHDR pwh,
UINT cbwh
);
Paramètres
hwi
Gérez le périphérique d’entrée audio de forme d’onde.
pwh
Pointeur vers une structure WAVEHDR identifiant la mémoire tampon à nettoyer.
cbwh
Taille, en octets, de la structure WAVEHDR .
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 |
|---|---|
|
Le handle d’appareil spécifié n’est pas valide. |
|
Aucun pilote de périphérique n’est présent. |
|
Impossible d’allouer ou de verrouiller la mémoire. |
|
La mémoire tampon pointée vers le paramètre pwh se trouve toujours dans la file d’attente. |
Remarques
Cette fonction complète la fonction waveInPrepareHeader .
Vous devez appeler cette fonction 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 waveInAddBuffer , vous devez attendre que le pilote soit terminé avec la mémoire tampon avant d’appeler waveInUnprepareHeader. 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 zéro.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |