Compartilhar via

Função AVIBuildFilterA (vfw.h)

  • Artigo

A função AVIBuildFilter cria uma especificação de filtro que é posteriormente usada 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.

Valor de retorno

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.

Observações

Essa função acessa o registro para 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho vfw.h
biblioteca Vfw32.lib
de DLL Avifil32.dll

Consulte também

do AVIFile Functions

de Macros e Funções do AVIFile