Función AVIBuildFilterA (vfw.h)

La función AVIBuildFilter genera una especificación de filtro que posteriormente usa la función GetOpenFileName o GetSaveFileName .

Sintaxis

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

Parámetros

lpszFilter

Puntero al búfer que contiene la cadena de filtro.

cbFilter

Tamaño, en caracteres, del búfer al que apunta lpszFilter.

fSaving

Marca que indica si el filtro debe incluir formatos de lectura o escritura. Especifique TRUE para incluir formatos de escritura o FALSE para incluir formatos de lectura.

Valor devuelto

Devuelve AVIERR_OK si se realiza correctamente o si se produce un error de otro modo. Entre los valores de error posibles se incluyen los siguientes.

Código devuelto	Descripción
AVIERR_BUFFERTOOSMALL	El tamaño del búfer cbFilter era menor que la especificación de filtro generada.
AVIERR_MEMORY	No había suficiente memoria para completar la operación de lectura.

Comentarios

Esta función accede al Registro para todos los tipos de filtro que la biblioteca AVIFile puede usar para abrir, leer o escribir archivos multimedia. No busca en el disco duro archivos DLL y formatos de filtro.

Nota

El encabezado vfw.h define AVIBuildFilter como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vfw.h
Library	Vfw32.lib
Archivo DLL	Avifil32.dll

Consulte también

Funciones AVIFile

Funciones y macros AVIFile