Compartir a través de

Función waveOutWrite (mmeapi.h)

  • Artículo

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