Share via

Función acmStreamUnprepareHeader (msacm.h)

  • Artículo

La función acmStreamUnprepareHeader limpia la preparación realizada por la función acmStreamPrepareHeader para una secuencia de ACM. Se debe llamar a esta función después de finalizar el ACM con los búferes especificados. Una aplicación debe llamar a esta función antes de liberar los búferes de origen y destino.

Sintaxis

MMRESULT ACMAPI acmStreamUnprepareHeader(
  HACMSTREAM        has,
  LPACMSTREAMHEADER pash,
  DWORD             fdwUnprepare
);

Parámetros

has

Maneje hasta el vapor de conversión.

pash

Puntero a una estructura ACMSTREAMHEADER que identifica los búferes de origen y destino que no están preparados.

fdwUnprepare

Reservados; debe ser cero.

Valor devuelto

Devuelve cero si es correcto o si se produce un error en caso contrario. Entre los valores de error posibles se incluyen los siguientes.

Código devuelto Descripción
ACMERR_BUSY
 El encabezado de secuencia especificado en pash está actualmente en uso y no se puede preparar.
ACMERR_UNPREPARED
 El encabezado de secuencia especificado en pash no está preparado actualmente por la función acmStreamPrepareHeader .
MMSYSERR_INVALFLAG
 Al menos una marca no es válida.
MMSYSERR_INVALHANDLE
 El identificador especificado no es válido.
MMSYSERR_INVALPARAM
 Al menos un parámetro no es válido.

Comentarios

La falta de preparación de un encabezado de secuencia que ya no se ha preparado es un error. Una aplicación debe especificar las longitudes de búfer de origen y destino (cbSrcLength y cbDstLength, respectivamente) que se usaron durante una llamada a la instancia de acmStreamPrepareHeader correspondiente. Si no se restablecen estos valores de miembro, se producirá un error en acmStreamUnprepareHeader con un error de MMSYSERR_INVALPARAM.

El ACM puede recuperarse de algunos errores. ACM devolverá un error distinto de cero, pero el encabezado de secuencia no estará preparado correctamente. Para determinar si el encabezado de secuencia realmente no estaba preparado, una aplicación puede examinar la marca de ACMSTREAMHEADER_STATUSF_PREPARED. Si acmStreamUnprepareHeader devuelve correcto, el encabezado siempre no estará preparado.

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 msacm.h
Library Msacm32.lib
Archivo DLL Msacm32.dll

Consulte también

Funciones de compresión de audio

Administrador de compresión de audio