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 |
|---|---|
|
El identificador de dispositivo especificado no es válido. |
|
No hay ningún controlador de dispositivo presente. |
|
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 |