Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[La funzionalità associata a questa pagina, funzioni AVIFile e macro, è una funzionalità legacy. È stato sostituito da lettore di origine. lettore di origine è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi Lettore di Origine invece di Funzioni AVIFile e Macro, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Un'applicazione deve aprire un file AVI prima di leggere o scrivere. Per aprire un file AVI, usare la funzioneAVIFileOpen. AVIFileOpen restituisce l'indirizzo di un'interfaccia di file AVI contenente l'handle del file aperto e incrementa il conteggio dei riferimenti del file.
La funzione AVIFileOpen supporta i flag OF utilizzati con la funzione OpenFile. Se un'applicazione scrive in un file esistente, deve includere il flag OF_WRITE in AVIFileOpen. Analogamente, se l'applicazione crea e scrive in un nuovo file, è necessario includere i flag OF_CREATE e OF_WRITE in AVIFileOpen.
Quando si apre un file usando AVIFileOpen, è possibile usare un gestore di file predefinito oppure specificare un gestore di file personalizzato per leggere e scrivere nel file e nei relativi flussi di dati. In entrambi i casi, AVIFile cerca nel Registro di sistema il gestore di file corretto da usare. È necessario assicurarsi che i gestori di file personalizzati si trovino nel Registro di sistema prima che un'applicazione possa accedervi.
È possibile incrementare il numero di riferimenti di un file usando la funzione AVIFileAddRef. Ad esempio, è possibile eseguire questa operazione quando si passa un handle dell'interfaccia file a un'altra applicazione o quando si vuole mantenere aperto un file usando una funzione che normalmente chiude il file.
È possibile chiudere un file usando la funzione AVIFileRelease. La funzione AVIFileRelease decrementa il conteggio dei riferimenti di un file AVI, salva le modifiche apportate al file e quando il conteggio dei riferimenti raggiunge zero, chiude il file. Le applicazioni devono bilanciare il conteggio dei riferimenti includendo una chiamata a AVIFileRelease per ogni uso di AVIFileOpen e AVIFileAddRef.
Nota
Un'applicazione può aprire un file con uno o più thread di programma. Tuttavia, per ottenere prestazioni ottimali, un solo thread deve accedere al file in qualsiasi momento.