WaveOutUnprepareHeader, fonction (mmeapi.h)
La fonction waveOutUnprepareHeader nettoie la préparation effectuée par la fonction waveOutPrepareHeader . Cette fonction doit être appelée une fois le pilote de périphérique terminé avec un bloc de données. Vous devez appeler cette fonction avant de libérer la mémoire tampon.
Syntaxe
MMRESULT waveOutUnprepareHeader(
HWAVEOUT hwo,
LPWAVEHDR pwh,
UINT cbwh
);
Paramètres
hwo
Handle vers le périphérique de sortie audio de forme d’onde.
pwh
Pointeur vers une structure WAVEHDR identifiant le bloc de données à 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. |
|
Le bloc de données pointé par le paramètre pwh se trouve toujours dans la file d’attente. |
Notes
Cette fonction complète waveOutPrepareHeader. 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 waveOutWrite , vous devez attendre que le pilote soit terminé avec la mémoire tampon avant d’appeler waveOutUnprepareHeader.
La non-préparation d’une mémoire tampon qui n’a pas été préparée n’a aucun effet et la fonction retourne zéro.
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 |