Abrindo e fechando 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 AVIFileOpen, você pode usar um manipulador de arquivos padrão ou especificar um manipulador de arquivos personalizado para ler e gravar no arquivo e em seus fluxos de dados. Em ambos os casos, o AVIFile pesquisa no Registro o manipulador de arquivos correto a ser 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 enquanto usa 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ência, 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 obter o melhor desempenho possível, apenas um thread deve acessar o arquivo ao mesmo tempo.