структура 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 не задано значение sizeof(KS_BITMAPINFOHEADER).
Исходный фильтр может запросить, чтобы фильтр приемника принимает только часть видео, предоставляя значения, которые фактически определяют прямоугольник обрезки в элементе rcSource . Однако если фильтр приемника не проверка для прямоугольника обрезки при подключении, фильтр приемника просто отрисовывает все видео, фактически игнорируя любые сведения об обрезке, передаваемые из исходного фильтра в фильтр приемника.
В идеале фильтр приемника проверяет rcSource , и если фильтр приемника не поддерживает извлечение изображений, а прямоугольник не пуст, он отклоняет подключение. Фильтр должен использовать функцию Win32 SetRectEmpty для сброса прямоугольника до всех нулей (и IsRectEmpty для последующего проверка прямоугольника).
Элемент rcTarget задает прямоугольник назначения для видео. Большинство исходных фильтров устанавливают для этого элемента все нули. Подчиненный фильтр может запросить размещение видео в определенной области буферов, которые он предоставляет. В этом случае он вызывает функцию Win32 QueryAccept с непустимой целью.
Требования
| Требование | Значение |
|---|---|
| Заголовок | ksmedia.h (включая Ksmedia.h) |