Compartir a través de


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