структура KS_VIDEOINFO (ksmedia.h)
Структура KS_VIDEOINFO описывает растровое изображение и цветовые сведения для видеопотока.
Синтаксис
typedef struct tagKS_VIDEOINFO {
RECT rcSource;
RECT rcTarget;
DWORD dwBitRate;
DWORD dwBitErrorRate;
REFERENCE_TIME AvgTimePerFrame;
KS_BITMAPINFOHEADER bmiHeader;
union {
KS_RGBQUAD bmiColors[KS_iPALETTE_COLORS];
DWORD dwBitMasks[KS_iMASK_COLORS];
KS_TRUECOLORINFO TrueColorInfo;
};
} KS_VIDEOINFO, *PKS_VIDEOINFO;
Члены
rcSource
Указывает прямоугольник с вырезкой, который выбирает часть активного видеосигнала для использования.
rcTarget
Задает прямоугольник, указывающий, какая часть целевого буфера будет использоваться.
dwBitRate
Указывает значение, указывающее приблизительную скорость передачи данных видеопотока в битах в секунду.
dwBitErrorRate
Указывает значение, указывающее частоту ошибок данных видеопотока в битовых ошибках в секунду.
AvgTimePerFrame
Указывает среднее время на кадр в 100 единицах.
bmiHeader
Описывает KS_BITMAPINFOHEADER структуру, содержащую сведения о цвете и измерении растрового изображения видео.
bmiColors[KS_iPALETTE_COLORS]
Массив структур KS_RGBQUAD, указывающий цветовую палитру видео. Каждая структура представляет собой один цвет, который представляет собой сочетание красных, зеленых и синих интенсивностей.
dwBitMasks[KS_iMASK_COLORS]
Массив значений DWORD, указывающих битовые маски true-color.
TrueColorInfo
KS_TRUECOLORINFO структура, содержащая цветовую палитру и массив цветовой маски.
Замечания
Эта структура не должна использоваться, если для biSize члена KS_BITMAPINFOHEADER задано значение размера(KS_BITMAPINFOHEADER).
Исходный фильтр может запросить, чтобы фильтр приемника принимает только раздел видео, предоставляя значения, которые эффективно определяют прямоугольник обрезки в элементе rcSource. Однако если фильтр приемника не проверяет наличие прямоугольника обрезки при подключении, фильтр приемника просто отрисовывает все видео, эффективно игнорируя все данные обрезки, передаваемые из исходного фильтра в фильтр приемника.
В идеале фильтр приемника проверяет rcSource и если фильтр приемника не поддерживает извлечение изображений, а прямоугольник не пустым, то он отклоняет подключение. Фильтр должен использовать функцию Win32 SetRectEmpty для сброса прямоугольника на все нули (и IsRectEmpty для последующей проверки прямоугольника).
Элемент rcTarget указывает прямоугольник назначения для видео. Большинство исходных фильтров задают для этого элемента все нули. Нижестоящий фильтр может запросить, чтобы видео было помещено в определенную область буферов, которые он предоставляет. В этом случае он вызывает функцию Win32 QueryAccept с целевым объектом nonempty.
Требования
| Требование | Ценность |
|---|---|
| заголовка | ksmedia.h (include Ksmedia.h) |