Compartilhar via


Função AVIBuildFilterA (vfw.h)

A função AVIBuildFilter cria uma especificação de filtro que é usada posteriormente pela função GetOpenFileName ou GetSaveFileName .

Sintaxe

HRESULT AVIBuildFilterA(
  LPSTR lpszFilter,
  LONG  cbFilter,
  BOOL  fSaving
);

Parâmetros

lpszFilter

Ponteiro para o buffer que contém a cadeia de caracteres de filtro.

cbFilter

Tamanho, em caracteres, do buffer apontado por lpszFilter.

fSaving

Sinalizador que indica se o filtro deve incluir formatos de leitura ou gravação. Especifique TRUE para incluir formatos de gravação ou FALSE para incluir formatos de leitura.

Retornar valor

Retorna AVIERR_OK 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_BUFFERTOOSMALL
O tamanho do buffer cbFilter era menor que a especificação de filtro gerada.
AVIERR_MEMORY
Não havia memória suficiente para concluir a operação de leitura.

Comentários

Essa função acessa o registro de todos os tipos de filtro que a biblioteca AVIFile pode usar para abrir, ler ou gravar arquivos multimídia. Ele não pesquisa DLLs e formatos de filtro no disco rígido.

Observação

O cabeçalho vfw.h define AVIBuildFilter 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

Requisito Valor
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 AVIFile