Función AVISaveW (vfw.h)
La función AVISave crea un archivo mediante la combinación de flujos de datos de otros archivos o de memoria.
HRESULT AVISaveW(
LPCWSTR szFile,
CLSID *pclsidHandler,
AVISAVECALLBACK lpfnCallback,
int nStreams,
PAVISTREAM pfile,
LPAVICOMPRESSOPTIONS lpOptions,
...
);
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 llamando 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 se empareja con lpOptions. El par de parámetros se puede repetir como un número variable de argumentos.
lpOptions
Puntero a una estructura de
...
Devuelve AVIERR_OK si se realiza correctamente o si se produce un error.
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
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 Conventions for Function Prototypes.
Requisito | Valor |
---|---|
cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
de la plataforma de destino de |
Windows |
encabezado de |
vfw.h |
biblioteca de |
Vfw32.lib |
DLL de |
Avifil32.dll |
funciones AVIFile de