fonction waveOutClose (mmeapi.h)

La fonction waveOutClose ferme le périphérique de sortie audio de forme d’onde donné.

Syntaxe

MMRESULT waveOutClose(
  HWAVEOUT hwo
);

Paramètres

hwo

Gérez le périphérique de sortie audio de forme d’onde. Si la fonction réussit, le handle n’est plus valide après cet appel.

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
Il existe encore des mémoires tampons dans la file d’attente.

Remarques

L’opération de fermeture échoue si l’appareil lit toujours une mémoire tampon audio de forme d’onde qui a été envoyée précédemment en appelant waveOutWrite. Avant d’appeler waveOutClose, l’application doit attendre la fin de la lecture de toutes les mémoires tampons ou appeler la fonction waveOutReset pour arrêter la lecture.

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