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

Статья
03/03/2024

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

Синтаксис

HRESULT AVIBuildFilterW(
  LPWSTR lpszFilter,
  LONG   cbFilter,
  BOOL   fSaving
);

Параметры

lpszFilter

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

cbFilter

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

fSaving

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

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

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

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

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

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	vfw.h
Библиотека	Vfw32.lib
DLL	Avifil32.dll

См. также раздел

Функции AVIFile

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

Share via