WaveOutUnprepareHeader, fonction (mmeapi.h)

  • Article

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
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
 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

Voir aussi

Waveform Audio

Fonctions de forme d’onde