Метод IGetFrame::SetFormat (vfw.h)

Статья
08/27/2023

Метод SetFormat задает формат распаковываемого изображения извлекаемых кадров и при необходимости предоставляет буфер для операции распаковки.

Синтаксис

HRESULT SetFormat(
  LPBITMAPINFOHEADER lpbi,
  LPVOID             lpBits,
  int                x,
  int                y,
  int                dx,
  int                dy
);

Параметры

lpbi

Указатель на структуру BITMAPINFOHEADER, определяющую формат распаковки изображения. Вы также можете указать значение NULL или значение ((LPBITMAPINFOHEADER) 1) для этого параметра. Значение NULL приводит к тому, что распаковка выбирает формат, подходящий для редактирования (обычно это 24-разрядный формат глубины изображения). Значение ((LPBITMAPINFOHEADER) 1) заставляет декомпрессор выбрать формат, соответствующий текущему режиму отображения.

lpBits

Указатель на буфер, содержащий распакованные данные изображения. Укажите ЗНАЧЕНИЕ NULL , чтобы этот метод выделил буфер.

x

Координата X целевого прямоугольника в DIB, заданном lpbi. Этот параметр используется, если lpBits не имеет значение NULL.

y

Координата Y целевого прямоугольника в DIB, заданном lpbi. Этот параметр используется, если lpBits не имеет значение NULL.

dx

Ширина прямоугольника назначения. Этот параметр используется, если lpBits не имеет значение NULL.

dy

Высота прямоугольника назначения. Этот параметр используется, если lpBits не имеет значение NULL.

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

Возвращает значение NOERROR в случае успешного выполнения, E_OUTOFMEMORY , если распаковка изображения превышает размер буфера, или E_FAIL в противном случае.

Требования


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

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

Пользовательские интерфейсы обработчика файлов и потоков

Пользовательские обработчики файлов и потоков

Share via