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 |
|---|---|
|
No se pudo leer el archivo, lo que indica un archivo dañado o un formato no reconocido. |
|
No se pudo abrir el archivo debido a memoria insuficiente. |
|
Error de disco al leer el archivo. |
|
Error de disco al abrir el archivo. |
|
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 |