Función waveOutPrepareHeader (mmeapi.h)

La función waveOutPrepareHeader prepara un bloque de datos de audio de forma de onda para su reproducción.

Sintaxis

MMRESULT waveOutPrepareHeader(
  HWAVEOUT  hwo,
  LPWAVEHDR pwh,
  UINT      cbwh
);

Parámetros

hwo

Controle el dispositivo de salida de forma de onda y audio.

pwh

Puntero a una estructura WAVEHDR que identifica el bloque de datos que se va a preparar.

cbwh

Tamaño, en bytes, de la estructura WAVEHDR .

Valor devuelto

Devuelve MMSYSERR_NOERROR si se realiza correctamente o si se produce un error de otro modo. Entre los valores de error posibles se incluyen los siguientes.

Código devuelto	Descripción
MMSYSERR_INVALHANDLE	El identificador de dispositivo especificado no es válido.
MMSYSERR_NODRIVER	No hay ningún controlador de dispositivo presente.
MMSYSERR_NOMEM	No se puede asignar o bloquear la memoria.

Comentarios

Establezca los miembros lpData, dwBufferLength y dwFlags de la estructura WAVEHDR antes de llamar a esta función. Establezca el miembro dwFlags en cero.

Los miembros dwFlags, dwBufferLength y dwLoops de la estructura WAVEHDR pueden cambiar entre las llamadas a esta función y la función waveOutWrite . Si cambia el tamaño especificado por dwBufferLength antes de la llamada a waveOutWrite, el nuevo valor debe ser menor que el valor preparado.

Si el método se ejecuta correctamente, la marca WHDR_PREPARED se establece en el miembro dwFlags de la estructura WAVEHDR .

La preparación de un encabezado que ya se ha preparado no tiene ningún efecto y la función devuelve cero.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mmeapi.h (incluya Mmeapi.h, Windows.h)
Library	Winmm.lib
Archivo DLL	Winmm.dll

Consulte también

Audio de forma de onda

Funciones de forma de onda