Función AVIFileOpenW (vfw.h)

La función AVIFileOpen abre un archivo AVI y devuelve la dirección de una interfaz de archivo usada para acceder a él. La biblioteca AVIFile mantiene un recuento del número de veces que se abre un archivo, pero no el número de veces que se lanzó. Use la función AVIFileRelease para liberar el archivo y disminuir el recuento.

Sintaxis

HRESULT AVIFileOpenW(
  PAVIFILE *ppfile,
  LPCWSTR  szFile,
  UINT     uMode,
  LPCLSID  lpHandler
);

Parámetros

ppfile

Puntero a un búfer que recibe el nuevo puntero de interfaz IAVIFile.

szFile

Cadena terminada en NULL que contiene el nombre del archivo que se va a abrir.

uMode

Modo de acceso que se va a usar al abrir el archivo. El modo de acceso predeterminado es OF_READ. Los siguientes modos de acceso se pueden especificar con AVIFileOpen.

Valor	Significado
OF_CREATE	Crea un nuevo archivo. Si el archivo ya existe, se trunca a una longitud cero.
OF_PARSE	Omite las operaciones que consumen mucho tiempo, como la creación de un índice. Establezca esta marca si desea que la función devuelva lo antes posible, por ejemplo, si va a consultar las propiedades del archivo, pero no leer el archivo.
OF_READ	Abre el archivo para leerlo.
OF_READWRITE	Abre el archivo para leer y escribir.
OF_SHARE_DENY_NONE	Abre el archivo de forma noclusiva. Otros procesos pueden abrir el archivo con acceso de lectura o escritura. AVIFileOpen produce un error si otro proceso ha abierto el archivo en modo de compatibilidad.
OF_SHARE_DENY_READ	Abre el archivo de forma noclusiva. Otros procesos pueden abrir el archivo con acceso de escritura. AVIFileOpen produce un error si otro proceso ha abierto el archivo en modo de compatibilidad o tiene acceso de lectura a él.
OF_SHARE_DENY_WRITE	Abre el archivo de forma noclusiva. Otros procesos pueden abrir el archivo con acceso de lectura. AVIFileOpen produce un error si otro proceso ha abierto el archivo en modo de compatibilidad o tiene acceso de escritura a él.
OF_SHARE_EXCLUSIVE	Abre el archivo y deniega a otros procesos el acceso a él. AVIFileOpen produce un error si algún otro proceso ha abierto el archivo.
OF_WRITE	Abre el archivo para escribir.

lpHandler

Puntero a un identificador de clase del controlador estándar o personalizado que desea usar. Si el valor es NULL, el sistema elige un controlador del Registro en función de la extensión de archivo o el tipo RIFF especificado en el archivo.

Valor devuelto

Devuelve cero si se ejecuta correctamente o si se produce un error. Entre los posibles valores de error se incluyen los siguientes.

Código devuelto	Descripción
AVIERR_BADFORMAT	No se pudo leer el archivo, lo que indica un archivo dañado o un formato no reconocido.
AVIERR_MEMORY	No se pudo abrir el archivo debido a una memoria insuficiente.
AVIERR_FILEREAD	Error de disco al leer el archivo.
AVIERR_FILEOPEN	Error de disco al abrir el archivo.
REGDB_E_CLASSNOTREG	Según el Registro, el tipo de archivo especificado en AVIFileOpen no tiene un controlador para procesarlo.

Observaciones

Nota

El encabezado vfw.h define AVIFileOpen 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

AVIFileRelease