Función AVISaveVA (vfw.h)
La función AVISaveV compila un archivo mediante la combinación de flujos de datos de otros archivos o de memoria.
Sintaxis
HRESULT AVISaveVA(
LPCSTR szFile,
CLSID *pclsidHandler,
AVISAVECALLBACK lpfnCallback,
int nStreams,
PAVISTREAM *ppavi,
LPAVICOMPRESSOPTIONS *plpOptions
);
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 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 que se usa para mostrar información de estado y para permitir que el usuario cancele la operación de guardado.
nStreams
Número de secuencias que se van a guardar.
ppavi
Puntero a una matriz de punteros a las estructuras de función AVISTREAM . La matriz usa un puntero para cada secuencia.
plpOptions
Puntero a una matriz de punteros a estructuras AVICOMPRESSOPTIONS . La matriz usa un puntero para cada secuencia.
Valor devuelto
Devuelve AVIERR_OK si se realiza correctamente o si se produce un error de otro modo.
Comentarios
Esta función es equivalente a la función AVISave , excepto que las secuencias se pasan en una matriz en lugar de como un número variable de argumentos.
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 son matrices que identifican las secuencias que se van a guardar en el archivo y definen las opciones de compresión de esos flujos.
Una aplicación debe asignar memoria para las estructuras AVICOMPRESSOPTIONS y la matriz de punteros a estas estructuras.
El argumento ppavi contiene la dirección de un puntero a una interfaz IAVIStream .
Nota
El encabezado vfw.h define AVISaveV 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 |