Метод IGetFrame::SetFormat (vfw.h)
Метод 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 в противном случае.
Комментарии
Параметры x, y, dx и dy определяют часть растрового изображения, заданного lpbi и lpBits , которая получает распаковку изображения.
Для обработчиков, написанных на C++, SetFormat имеет следующий синтаксис:
HRESULT SetFormat(LPBITMAPINFOHEADER lpbi, LPVOID lpBits, int x,
int y, int dx, int dy);
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | vfw.h |
| Библиотека | Vfw32.lib |