Partager via


waveInPrepareHeader, fonction (mmeapi.h)

La fonction waveInPrepareHeader prépare une mémoire tampon pour l’entrée audio de forme d’onde.

Syntaxe

MMRESULT waveInPrepareHeader(
  HWAVEIN   hwi,
  LPWAVEHDR pwh,
  UINT      cbwh
);

Paramètres

hwi

Handle vers le périphérique d’entrée audio de forme d’onde.

pwh

Pointeur vers une structure WAVEHDR qui identifie la mémoire tampon à préparer.

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.

Remarques

Les membres lpData, dwBufferLength et dwFlags de la structure WAVEHDR doivent être définis avant d’appeler cette fonction (dwFlags doit être égal à 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

Waveform Audio

Fonctions de forme d’onde