Compartir a través de

Función waveInUnprepareHeader (mmeapi.h)

  • Artículo

La función waveInUnprepareHeader limpia la preparación realizada por la función waveInPrepareHeader . Se debe llamar a esta función después de que el controlador del dispositivo rellene un búfer y lo devuelva a la aplicación. Debe llamar a esta función antes de liberar el búfer.

Sintaxis

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

Parámetros

hwi

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

pwh

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

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_STILLPLAYING
 El búfer al que apunta el parámetro pwh todavía está en la cola.

Comentarios

Esta función complementa la función waveInPrepareHeader .

Debe llamar a esta función antes de liberar el búfer. Después de pasar un búfer al controlador del dispositivo con la función waveInAddBuffer , debe esperar hasta que finalice el controlador con el búfer antes de llamar a waveInUnprepareHeader. La anulación de la preparación de un búfer que no se ha preparado no tiene ningún efecto y la función devuelve 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 (incluya Windows.h)
Library Winmm.lib
Archivo DLL Winmm.dll

Consulte también

Audio de forma de onda

Funciones de forma de onda