Função AVIFileOpen (vfw.h)

  • Artigo

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