Función AVISaveA (vfw.h)

La función AVISave crea un archivo mediante la combinación de flujos de datos de otros archivos o de memoria.

Sintaxis

HRESULT AVISaveA(
  LPCSTR               szFile,
  CLSID                *pclsidHandler,
  AVISAVECALLBACK      lpfnCallback,
  int                  nStreams,
  PAVISTREAM           pfile,
  LPAVICOMPRESSOPTIONS lpOptions,
  ...                  
);

Parámetros

szFile

Cadena terminada en NULL que contiene el nombre del archivo que se va a guardar.

pclsidHandler

Puntero al controlador de archivos usado para escribir el archivo. El archivo se crea mediante una llamada a la función AVIFileOpen mediante este controlador. Si no se especifica un controlador, se selecciona un valor predeterminado del Registro en función de la extensión de archivo.

lpfnCallback

Puntero a una función de devolución de llamada para la operación de guardado.

nStreams

Número de secuencias guardadas en el archivo.

pfile

Puntero a una secuencia AVI. Este parámetro está emparejado con lpOptions. El par de parámetros se puede repetir como un número variable de argumentos.

lpOptions

Puntero a una estructura AVICOMPRESSOPTIONS definida por la aplicación que contiene las opciones de compresión de la secuencia a la que hace referencia pavi. Este parámetro está emparejado con pavi. El par de parámetros se puede repetir como un número variable de argumentos.

...

Valor devuelto

Devuelve AVIERR_OK si se ejecuta correctamente o si se produce un error.

Comentarios

Esta función crea un archivo, copia los datos del flujo en el archivo, cierra el archivo y libera los recursos usados por el nuevo archivo. Los dos últimos parámetros de esta función identifican una secuencia que se va a guardar en el archivo y definen las opciones de compresión de esa secuencia. Al guardar más de una secuencia en un archivo AVI, repita estos dos parámetros específicos de la secuencia para cada secuencia del archivo.

Una función de devolución de llamada (a la que se hace referencia mediante lpfnCallback) puede mostrar información de estado y permitir que el usuario cancele la operación de guardado. La función de devolución de llamada usa el formato siguiente:

LONG PASCAL SaveCallback(int nPercent)  

El parámetro nPercent especifica el porcentaje del archivo guardado.

La función de devolución de llamada debe devolver AVIERR_OK si la operación debe continuar y AVIERR_USERABORT si el usuario desea anular la operación de guardado.

El argumento pavi es un puntero a una interfaz IAVIStream .

Nota

El encabezado vfw.h define AVISave como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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	vfw.h
Library	Vfw32.lib
Archivo DLL	Avifil32.dll

Consulte también

Funciones AVIFile

Funciones y macros AVIFile