WaveOutPrepareHeader, fonction (mmeapi.h)
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 |
|---|---|
|
Le handle d’appareil spécifié n’est pas valide. |
|
Aucun pilote de périphérique n’est présent. |
|
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 |