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

Статья
08/27/2023

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

Синтаксис

HIC VFWAPI ICLocate(
  DWORD              fccType,
  DWORD              fccHandler,
  LPBITMAPINFOHEADER lpbiIn,
  LPBITMAPINFOHEADER lpbiOut,
  WORD               wFlags
);

Параметры

fccType

Четырехзначный код, указывающий тип открываемого компрессора или распаковки. Для видеопотоков этот параметр имеет значение VIDC.

fccHandler

Предпочтительный обработчик указанного типа. Как правило, тип обработчика хранится в заголовке потока в AVI-файле. Укажите значение NULL , если приложение может использовать любой тип обработчика или оно не знает, какой тип обработчика следует использовать.

lpbiIn

Указатель на структуру BITMAPINFOHEADER, определяющую формат входных данных. Ручка компрессора не возвращается, если она не поддерживает этот формат.

lpbiOut

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

Если этот параметр не является нулевым, дескриптор компрессора не возвращается, если он не может создать этот выходной формат.

wFlags

Флаги, описывающие критерии поиска для компрессора или распаковки. Определяются следующие значения:

Значение	Значение
ICMODE_COMPRESS	Находит компрессор, который может сжимать изображение в формате, определенном lpbiIn , до формата, определенного lpbiOut.
ICMODE_DECOMPRESS	Находит распаковку, которая может распаковывать изображение в формате, определенном lpbiIn , в формат, определенный lpbiOut.
ICMODE_DRAW	Находит распаковку, которая может распаковывать изображение в формате, определенном lpbiIn , и рисовать его непосредственно на оборудовании.
ICMODE_FASTCOMPRESS	Имеет то же значение, что и ICMODE_COMPRESS за исключением того, что компрессор используется для работы в режиме реального времени и подчеркивает скорость над качеством.
ICMODE_FASTDECOMPRESS	Имеет то же значение, что и ICMODE_DECOMPRESS за исключением того, что распаковка используется для операций в режиме реального времени и подчеркивает скорость над качеством.

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

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

Требования

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

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

Функции сжатия видео

Диспетчер сжатия видео

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