Funzione AVIFileOpenA (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
Sintassi
HRESULT AVIFileOpenA(
PAVIFILE *ppfile,
LPCSTR szFile,
UINT uMode,
LPCLSID lpHandler
);
Parametri
ppfile
Puntatore a un buffer che riceve il nuovo puntatore dell'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. È possibile specificare le modalità di accesso seguenti con AVIFileOpen.
| Valore | Significato |
|---|---|
| OF_CREATE | Crea un nuovo file. Se il file esiste già, viene troncato a lunghezza zero. |
| OF_PARSE | Ignora 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 desidera 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 possibili valori di errore 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. |
|
Si è verificato un errore del disco durante la lettura del file. |
|
Si è verificato un 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. |
Osservazioni
Nota
L'intestazione vfw.h definisce AVIFileOpen come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 2000 Professional [solo app desktop] |
| server minimo supportato | Windows 2000 Server [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
vfw.h |
| libreria |
Vfw32.lib |
| dll | Avifil32.dll |