Função AVIFileOpenW (vfw.h)
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 AVIFileOpenW(
PAVIFILE *ppfile,
LPCWSTR 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 |
|---|---|
|
O arquivo não pôde ser lido, indicando um arquivo corrompido ou um formato não reconhecido. |
|
O arquivo não pôde ser aberto devido à memória insuficiente. |
|
Ocorreu um erro de disco ao ler o arquivo. |
|
Ocorreu um erro de disco ao abrir o arquivo. |
|
De acordo com o registro, o tipo de arquivo especificado em AVIFileOpen não tem um manipulador para processá-lo. |
Comentários
Observação
O cabeçalho vfw.h define AVIFileOpen como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
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 |