Compartir a través de


Función waveInPrepareHeader (mmeapi.h)

La función waveInPrepareHeader prepara un búfer para la entrada de audio de forma de onda.

Sintaxis

MMRESULT waveInPrepareHeader(
  HWAVEIN   hwi,
  LPWAVEHDR pwh,
  UINT      cbwh
);

Parámetros

hwi

Controle el dispositivo de entrada de audio con forma de onda.

pwh

Puntero a una estructura WAVEHDR que identifica el búfer que se va a preparar.

cbwh

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

Valor devuelto

Devuelve MMSYSERR_NOERROR si se ejecuta correctamente o si se produce un error. Entre los posibles valores de error 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

Los miembros lpData, dwBufferLength y dwFlags de la estructura WAVEHDR deben establecerse antes de llamar a esta función (dwFlags debe ser cero).

Requisitos

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

Consulte también

Audio de forma de onda

Funciones de forma de onda