Функция AVIBuildFilterA (vfw.h)

Статья
11/20/2024

Функция AVIBuildFilter создает спецификацию фильтра, которая впоследствии используется функцией getOpenFileName или GetSaveFileName.

Синтаксис

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

Параметры

lpszFilter

Указатель на буфер, содержащий строку фильтра.

cbFilter

Размер в символах буфера, на который указывает lpszFilter.

fSaving

Флаг, указывающий, должен ли фильтр включать форматы чтения или записи. Укажите TRUE для включения форматов записи или FALSE для включения форматов чтения.

Возвращаемое значение

Возвращает AVIERR_OK, если успешно или ошибка в противном случае. Возможные значения ошибок включают следующие значения.

Возвращаемый код	Описание
AVIERR_BUFFERTOOSMALL	Размер буфера cbFilter был меньше спецификации созданного фильтра.
AVIERR_MEMORY	Недостаточно памяти для завершения операции чтения.

Замечания

Эта функция обращается к реестру для всех типов фильтров, которые библиотека AVIFile может использовать для открытия, чтения или записи мультимедийных файлов. Он не выполняет поиск жесткого диска для фильтрации БИБЛИОТЕК DLL и форматов.

Заметка

Заголовок vfw.h определяет AVIBuildFilter как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	vfw.h
библиотеки	Vfw32.lib
DLL	Avifil32.dll

См. также

функции AVIFile

функции и макросы AVIFile

Поделиться через