Leer en inglés

Compartir a través de


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.

Sintaxis

HRESULT AVISaveW(
  LPCWSTR              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 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 AVICOMPRESSOPTIONS definida por la aplicación que contiene las opciones de compresión para 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 realiza correctamente o si se produce un error.

Observaciones

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 Conventions for Function Prototypes.

Requisitos

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

Consulte también

funciones AVIFile de

funciones y macros AVIFile