Abrir e fechar arquivos

Um aplicativo deve abrir um arquivo AVI antes de ler ou gravar. Para abrir um arquivo AVI, use a função AVIFileOpen . AVIFileOpen retorna o endereço de uma interface de arquivo AVI que contém o identificador do arquivo aberto e incrementa a contagem de referência do arquivo.

A função AVIFileOpen dá suporte aos sinalizadores OF usados com a função OpenFile . Se um aplicativo gravar em um arquivo existente, ele deverá incluir o sinalizador OF_WRITE no AVIFileOpen. Da mesma forma, se o aplicativo criar e gravar em um novo arquivo, você deverá incluir os sinalizadores OF_CREATE e OF_WRITE no AVIFileOpen.

Ao abrir um arquivo usando a AVIFileOpen, você pode usar um manipulador de arquivos padrão ou especificar um manipulador de arquivos personalizado para ler e gravar no arquivo e seus fluxos de dados. Em ambos os casos, o AVIFile pesquisa o registro para que o manipulador de arquivos correto seja usado. Você deve garantir que manipuladores de arquivos personalizados estejam no registro antes que um aplicativo possa acessá-los.

Você pode incrementar a contagem de referência de um arquivo usando a função AVIFileAddRef . Por exemplo, talvez você queira fazer isso ao passar um identificador da interface do arquivo para outro aplicativo ou quando quiser manter um arquivo aberto usando uma função que normalmente fecharia o arquivo.

Você pode fechar um arquivo usando a função AVIFileRelease . A função AVIFileRelease diminui a contagem de referência de um arquivo AVI, salva as alterações feitas no arquivo e, quando a contagem de referência atinge zero, fecha o arquivo. Seus aplicativos devem equilibrar a contagem de referências incluindo uma chamada para AVIFileRelease para cada uso de AVIFileOpen e AVIFileAddRef.

Observação

Um aplicativo pode abrir um arquivo com um ou mais threads de programa. No entanto, para o melhor desempenho possível, apenas um thread deve acessar o arquivo de uma só vez.