fonction waveInUnprepareHeader (mmeapi.h)

  • Article

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
MMSYSERR_INVALHANDLE
 Le handle d’appareil spécifié n’est pas valide.
MMSYSERR_NODRIVER
 Aucun pilote de périphérique n’est présent.
MMSYSERR_NOMEM
 Impossible d’allouer ou de verrouiller la mémoire.
WAVERR_STILLPLAYING
 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

Voir aussi

Audio de forme d’onde

Fonctions de forme d’onde