Estructura WAVEHDR (mmeapi.h)

La estructura WAVEHDR define el encabezado utilizado para identificar un búfer de audio de forma de onda.

Sintaxis

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;

Miembros

lpData

Puntero al búfer de forma de onda.

dwBufferLength

Longitud, en bytes, del búfer.

dwBytesRecorded

Cuando se usa el encabezado en la entrada, especifica la cantidad de datos en el búfer.

dwUser

Datos de usuario.

dwFlags

OR bit a bit de cero o más marcas. Se definen las marcas siguientes:

Nombre	Descripción
WHDR_BEGINLOOP	Este búfer es el primer búfer de un bucle. Esta marca solo se usa con búferes de salida.
WHDR_DONE	Establezca por el controlador de dispositivo para indicar que ha terminado con el búfer y lo devuelve a la aplicación.
WHDR_ENDLOOP	Este búfer es el último búfer de un bucle. Esta marca solo se usa con búferes de salida.
WHDR_INQUEUE	Establezca por Windows para indicar que el búfer está en cola para su reproducción.
WHDR_PREPARED	Establezca por Windows para indicar que el búfer se ha preparado con la función waveInPrepareHeader o waveOutPrepareHeader .

dwLoops

Número de veces que se va a reproducir el bucle. Este miembro solo se usa con búferes de salida.

lpNext

Reservado.

reserved

Reservado.

Comentarios

Use las marcas WHDR_BEGINLOOP y WHDR_ENDLOOP en el miembro dwFlags para especificar los bloques de datos iniciales y finales para el bucle. Para bucle en un único bloque, especifique ambas marcas para el mismo bloque. Use el miembro dwLoops en la estructura WAVEHDR del primer bloque del bucle para especificar el número de veces que se va a reproducir el bucle.

Los miembros lpData, dwBufferLength y dwFlags deben establecerse antes de llamar a la función waveInPrepareHeader o waveOutPrepareHeader . (Para cualquiera de las funciones, el miembro dwFlags debe establecerse en cero).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	mmeapi.h (incluya Windows.h)

Consulte también

Audio de forma de onda

Estructuras de forma de onda

waveInPrepareHeader

waveOutPrepareHeader