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 |