Funzione AVIFileOpen (vfw.h)

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