Compartir a través de


Función AVIFileOpen (vfw.h)

La función AVIFileOpen abre un archivo AVI y devuelve la dirección de una interfaz de archivo utilizada 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 publicó. Use la función AVIFileRelease para liberar el archivo y disminuir el recuento.

Sintaxis

HRESULT AVIFileOpen(
  PAVIFILE *ppfile,
  LPCSTR   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. Se pueden especificar los siguientes modos de acceso 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 su lectura.
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 cualquier 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 es correcto o si se produce un error de lo contrario. 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 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.

Requisitos

   
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

AVIFileRelease