Función waveOutWrite (mmeapi.h)

La función waveOutWrite envía un bloque de datos al dispositivo de salida de audio de forma de onda determinado.

Sintaxis

MMRESULT waveOutWrite(
  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 contiene información sobre el bloque de datos.

cbwh

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

Valor devuelto

Devuelve MMSYSERR_NOERROR si se realiza correctamente o si se produce un error en caso contrario. 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.
WAVERR_UNPREPARED	El bloque de datos al que apunta el parámetro pwh no se ha preparado.

Comentarios

Cuando finalice el búfer, el bit de WHDR_DONE se establece en el miembro dwFlags de la estructura WAVEHDR .

El búfer debe estar preparado con la función waveOutPrepareHeader antes de pasarla a waveOutWrite. A menos que el dispositivo esté en pausa llamando a la función waveOutPause , la reproducción comienza cuando se envía el primer bloque de datos al dispositivo.

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 Windows.h)
Library	Winmm.lib
Archivo DLL	Winmm.dll

Consulte también

Audio de forma de onda

Funciones de forma de onda