Compartir a través de

Estructura WAVEHDR (mmeapi.h)

  • Artículo

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