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

Consulte también

Funciones AVIFile

Funciones y macros AVIFile