Structure WAVEHDR (mmeapi.h)

Article
03/04/2024

La structure WAVEHDR définit l’en-tête utilisé pour identifier une mémoire tampon audio de forme d’onde.

Syntaxe

typedef struct wavehdr_tag {
  LPSTR              lpData;
  DWORD              dwBufferLength;
  DWORD              dwBytesRecorded;
  DWORD_PTR          dwUser;
  DWORD              dwFlags;
  DWORD              dwLoops;
  struct wavehdr_tag *lpNext;
  DWORD_PTR          reserved;
} WAVEHDR, *PWAVEHDR, *NPWAVEHDR, *LPWAVEHDR;

Membres

lpData

Pointeur vers la mémoire tampon de forme d’onde.

dwBufferLength

Longueur, en octets, de la mémoire tampon.

dwBytesRecorded

Lorsque l’en-tête est utilisé en entrée, spécifie la quantité de données contenues dans la mémoire tampon.

dwUser

Données utilisateur.

dwFlags

Or au niveau du bit de zéro ou plus d’indicateurs. Les indicateurs suivants sont définis :

Nom	Description
WHDR_BEGINLOOP	Cette mémoire tampon est la première mémoire tampon d’une boucle. Cet indicateur est utilisé uniquement avec les mémoires tampons de sortie.
WHDR_DONE	Défini par le pilote de périphérique pour indiquer qu’il a terminé la mémoire tampon et qu’elle est retournée à l’application.
WHDR_ENDLOOP	Cette mémoire tampon est la dernière mémoire tampon d’une boucle. Cet indicateur est utilisé uniquement avec les mémoires tampons de sortie.
WHDR_INQUEUE	Défini par Windows pour indiquer que la mémoire tampon est mise en file d’attente pour la lecture.
WHDR_PREPARED	Défini par Windows pour indiquer que la mémoire tampon a été préparée avec la fonction waveInPrepareHeader ou waveOutPrepareHeader .

dwLoops

Nombre de fois où lire la boucle. Ce membre est utilisé uniquement avec les mémoires tampons de sortie.

lpNext

Réservé.

reserved

Réservé.

Remarques

Utilisez les indicateurs WHDR_BEGINLOOP et WHDR_ENDLOOP dans le membre dwFlags pour spécifier les blocs de données de début et de fin pour la boucle. Pour effectuer une boucle sur un seul bloc, spécifiez les deux indicateurs pour le même bloc. Utilisez le membre dwLoops dans la structure WAVEHDR pour le premier bloc de la boucle pour spécifier le nombre de fois où lire la boucle.

Les membres lpData, dwBufferLength et dwFlags doivent être définis avant d’appeler la fonction waveInPrepareHeader ou waveOutPrepareHeader . (Pour l’une ou l’autre des fonctions, le membre dwFlags doit être défini sur 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]
En-tête	mmeapi.h (inclure Windows.h)

Voir aussi

Audio de forme d’onde

Structures de forme d’onde

waveInPrepareHeader

waveOutPrepareHeader

Partager via