Функция ICDrawBegin (vfw.h)
Функция ICDrawBegin инициализирует отрисовщик и подготавливает назначение рисования к рисованию.
Синтаксис
DWORD VFWAPIV ICDrawBegin(
HIC hic,
DWORD dwFlags,
HPALETTE hpal,
HWND hwnd,
HDC hdc,
int xDst,
int yDst,
int dxDst,
int dyDst,
LPBITMAPINFOHEADER lpbi,
int xSrc,
int ySrc,
int dxSrc,
int dySrc,
DWORD dwRate,
DWORD dwScale
);
Параметры
hic
Дескриптор для использования распаковки.
dwFlags
Флаги распаковки. Определены следующие значения.
| Значение | Значение |
|---|---|
| ICDRAW_ANIMATE | Приложение может анимировать палитру. |
| ICDRAW_CONTINUE | Рисунок является продолжением предыдущего кадра. |
| ICDRAW_FULLSCREEN | Рисует распакованные данные в полноэкранном режиме. |
| ICDRAW_HDC | Рисует распакованные данные в окно или контроллер домена. |
| ICDRAW_MEMORYDC | Контроллер домена находится вне экрана. |
| ICDRAW_QUERY | Определяет, может ли распаковка данных распаковыватель. Драйвер не распаковывая данные. |
| ICDRAW_UPDATING | Текущий кадр обновляется, а не воспроизводится. |
hpal
Дескриптор палитры, используемой для рисования.
hwnd
Дескриптор окна, используемого для рисования.
hdc
Контроллер домена, используемый для рисования.
xDst
Координата X правого верхнего угла прямоугольника назначения.
yDst
Координата по оси Y правого верхнего угла прямоугольника назначения.
dxDst
Ширина прямоугольника назначения.
dyDst
Высота прямоугольника назначения.
lpbi
Указатель на структуру BITMAPINFOHEADER, содержащую формат входных данных для распаковки.
xSrc
Координата X правого верхнего угла исходного прямоугольника.
ySrc
Координата Y правого верхнего угла исходного прямоугольника.
dxSrc
Ширина исходного прямоугольника.
dySrc
Высота исходного прямоугольника.
dwRate
Числитель частоты кадров. Частота кадров в кадрах в секунду получается путем деления dwRate на dwScale.
dwScale
Знаменатель частоты кадров. Частота кадров в кадрах в секунду получается путем деления dwRate на dwScale.
Возвращаемое значение
Возвращает ICERR_OK, может ли отрисовщик распаковыть данные или ICERR_UNSUPPORTED в противном случае.
Комментарии
Флаги ICDRAW_HDC и ICDRAW_FULLSCREEN являются взаимоисключающими. Если приложение задает флаг ICDRAW_HDC в dwFlags, распаковщик использует hwnd, hdc и параметры, определяющие прямоугольник назначения (xDst, yDst, dxDst и dyDst). Приложение должно задать для этих параметров размер прямоугольника назначения. Укажите значения прямоугольника назначения относительно текущего окна или контроллера домена.
Если приложение задает флаг ICDRAW_FULLSCREEN в dwFlags, параметры hwnd и hdc не используются и должны иметь значение NULL. Кроме того, прямоугольник назначения не используется, и его параметры можно задать равным нулю.
Исходный прямоугольник находится относительно полного кадра видео. Часть видеокадра, указанная в исходном прямоугольнике, растягивается или сужается в соответствии с прямоугольником назначения.
Параметры dwRate и dwScale определяют скорость распаковки. Целочисленное значение, указанное для dwRate , делимое на целочисленное значение, указанное для dwScale, определяет частоту кадров в кадрах в секунду. Это значение используется отрисовщиком, когда он отвечает за временные кадры во время воспроизведения.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | vfw.h |
| Библиотека | Vfw32.lib |
| DLL | Msvfw32.dll |