Funzione AVIFileOpen (vfw.h)

Articolo
08/27/2023

La funzione AVIFileOpen apre un file AVI e restituisce l'indirizzo di un'interfaccia file usata per accedervi. La libreria AVIFile gestisce un conteggio del numero di volte in cui un file viene aperto, ma non il numero di volte in cui è stato rilasciato. Usare la funzione AVIFileRelease per rilasciare il file e decrementare il conteggio.

Sintassi

HRESULT AVIFileOpen(
  PAVIFILE *ppfile,
  LPCSTR   szFile,
  UINT     uMode,
  LPCLSID  lpHandler
);

Parametri

ppfile

Puntatore a un buffer che riceve il nuovo puntatore all'interfaccia IAVIFile .

szFile

Stringa con terminazione Null contenente il nome del file da aprire.

uMode

Modalità di accesso da usare quando si apre il file. La modalità di accesso predefinita è OF_READ. Le modalità di accesso seguenti possono essere specificate con AVIFileOpen.

Valore	Significato
OF_CREATE	Crea un nuovo file. Se il file esiste già, viene troncato a lunghezza zero.
OF_PARSE	Ignora le operazioni che richiedono molto tempo, ad esempio la compilazione di un indice. Impostare questo flag se si desidera che la funzione restituisca il più rapidamente possibile, ad esempio se si intende eseguire una query sulle proprietà del file ma non leggere il file.
OF_READ	Apre il file per la lettura.
OF_READWRITE	Apre il file per la lettura e la scrittura.
OF_SHARE_DENY_NONE	Apre il file in modo non esclusivo. Altri processi possono aprire il file con accesso in lettura o scrittura. AVIFileOpen ha esito negativo se un altro processo ha aperto il file in modalità di compatibilità.
OF_SHARE_DENY_READ	Apre il file in modo non esclusivo. Altri processi possono aprire il file con accesso in scrittura. AVIFileOpen ha esito negativo se un altro processo ha aperto il file in modalità di compatibilità o ha accesso in lettura.
OF_SHARE_DENY_WRITE	Apre il file in modo non esclusivo. Altri processi possono aprire il file con accesso in lettura. AVIFileOpen ha esito negativo se un altro processo ha aperto il file in modalità di compatibilità o ha accesso in scrittura.
OF_SHARE_EXCLUSIVE	Apre il file e nega ad altri processi qualsiasi accesso. AVIFileOpen ha esito negativo se un altro processo ha aperto il file.
OF_WRITE	Apre il file per la scrittura.

lpHandler

Puntatore a un identificatore di classe del gestore standard o personalizzato che si vuole usare. Se il valore è NULL, il sistema sceglie un gestore dal Registro di sistema in base all'estensione di file o al tipo RIFF specificato nel file.

Valore restituito

Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito	Descrizione
AVIERR_BADFORMAT	Impossibile leggere il file, che indica un file danneggiato o un formato non riconosciuto.
AVIERR_MEMORY	Impossibile aprire il file a causa di memoria insufficiente.
AVIERR_FILEREAD	Errore del disco durante la lettura del file.
AVIERR_FILEOPEN	Errore del disco durante l'apertura del file.
REGDB_E_CLASSNOTREG	In base al Registro di sistema, il tipo di file specificato in AVIFileOpen non dispone di un gestore per elaborarlo.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vfw.h
Libreria	Vfw32.lib
DLL	Avifil32.dll

Vedi anche

Funzioni AVIFile

Funzioni e macro AVIFile

AVIFileRelease

Share via