Função AVIFileOpen (vfw.h)

Artigo
08/27/2023

A função AVIFileOpen abre um arquivo AVI e retorna o endereço de uma interface de arquivo usada para acessá-lo. A biblioteca AVIFile mantém uma contagem do número de vezes que um arquivo é aberto, mas não o número de vezes que foi liberado. Use a função AVIFileRelease para liberar o arquivo e diminuir a contagem.

Sintaxe

HRESULT AVIFileOpen(
  PAVIFILE *ppfile,
  LPCSTR   szFile,
  UINT     uMode,
  LPCLSID  lpHandler
);

Parâmetros

ppfile

Ponteiro para um buffer que recebe o novo ponteiro de interface IAVIFile .

szFile

Cadeia de caracteres terminada em nulo que contém o nome do arquivo a ser aberto.

uMode

Modo de acesso a ser usado ao abrir o arquivo. O modo de acesso padrão é OF_READ. Os modos de acesso a seguir podem ser especificados com AVIFileOpen.

Valor	Significado
OF_CREATE	Cria um arquivo novo. Se o arquivo já existir, ele será truncado para tamanho zero.
OF_PARSE	Ignora operações demoradas, como a criação de um índice. Defina esse sinalizador se quiser que a função retorne o mais rápido possível, por exemplo, se você for consultar as propriedades do arquivo, mas não ler o arquivo.
OF_READ	Abre o arquivo para leitura.
OF_READWRITE	Abre o arquivo para leitura e gravação.
OF_SHARE_DENY_NONE	Abre o arquivo de forma inexistente. Outros processos podem abrir o arquivo com acesso de leitura ou gravação. AVIFileOpen falhará se outro processo tiver aberto o arquivo no modo de compatibilidade.
OF_SHARE_DENY_READ	Abre o arquivo de forma inexistente. Outros processos podem abrir o arquivo com acesso de gravação. AVIFileOpen falhará se outro processo tiver aberto o arquivo no modo de compatibilidade ou tiver acesso de leitura a ele.
OF_SHARE_DENY_WRITE	Abre o arquivo de forma inexistente. Outros processos podem abrir o arquivo com acesso de leitura. AVIFileOpen falhará se outro processo tiver aberto o arquivo no modo de compatibilidade ou tiver acesso de gravação a ele.
OF_SHARE_EXCLUSIVE	Abre o arquivo e nega a outros processos qualquer acesso a ele. AVIFileOpen falhará se qualquer outro processo tiver aberto o arquivo.
OF_WRITE	Abre o arquivo para gravação.

lpHandler

Ponteiro para um identificador de classe do manipulador padrão ou personalizado que você deseja usar. Se o valor for NULL, o sistema escolherá um manipulador do registro com base na extensão de arquivo ou no tipo RIFF especificado no arquivo.

Valor retornado

Retorna zero se tiver êxito ou um erro de outra forma. Os valores de erro possíveis incluem o seguinte.

Código de retorno	Descrição
AVIERR_BADFORMAT	O arquivo não pôde ser lido, indicando um arquivo corrompido ou um formato não reconhecido.
AVIERR_MEMORY	O arquivo não pôde ser aberto devido à memória insuficiente.
AVIERR_FILEREAD	Ocorreu um erro de disco ao ler o arquivo.
AVIERR_FILEOPEN	Ocorreu um erro de disco ao abrir o arquivo.
REGDB_E_CLASSNOTREG	De acordo com o registro, o tipo de arquivo especificado em AVIFileOpen não tem um manipulador para processá-lo.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	vfw.h
Biblioteca	Vfw32.lib
DLL	Avifil32.dll

Confira também

Funções AVIFile

Funções e macros do AVIFile

AVIFileRelease

Compartilhar via