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 |
---|---|
|
O tamanho do buffer cbFilter era menor que a especificação de filtro gerada. |
|
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 |