Función AVIFileOpenW (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 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 nonexclusivamente. 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 nonexclusivamente. 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 nonexclusivamente. 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 cualquier 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 en caso contrario. Entre los valores de error posibles 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.

Comentarios

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 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

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