WaveOutPrepareHeader, fonction (mmeapi.h)

  • Article

La fonction waveOutPrepareHeader prépare un bloc de données audio de forme d’onde pour la lecture.

Syntaxe

MMRESULT waveOutPrepareHeader(
  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 qui identifie le bloc de données à 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.

Notes

Définissez les membres lpData, dwBufferLength et dwFlags de la structure WAVEHDR avant d’appeler cette fonction. Définissez le membre dwFlags sur zéro.

Les membres dwFlags, dwBufferLength et dwLoops de la structure WAVEHDR peuvent changer entre les appels à cette fonction et la fonction waveOutWrite . Si vous modifiez la taille spécifiée par dwBufferLength avant l’appel à waveOutWrite, la nouvelle valeur doit être inférieure à la valeur préparée.

Si la méthode réussit, l’indicateur WHDR_PREPARED est défini dans le membre dwFlags de la structure WAVEHDR .

La préparation d’un en-tête qui a déjà été préparé n’a aucun effet et la fonction retourne zéro.

Configuration requise

   
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 Mmeapi.h, Windows.h)
Bibliothèque Winmm.lib
DLL Winmm.dll

Voir aussi

Waveform Audio

Fonctions de forme d’onde