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 |
|---|---|
|
Impossibile leggere il file, che indica un file danneggiato o un formato non riconosciuto. |
|
Impossibile aprire il file a causa di memoria insufficiente. |
|
Errore del disco durante la lettura del file. |
|
Errore del disco durante l'apertura del file. |
|
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 |