Función acmStreamUnprepareHeader (msacm.h)

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.

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

Consulte también

Funciones de compresión de audio

Administrador de compresión de audio