структура KS_VIDEOINFOHEADER (ksmedia.h)
Структура KS_VIDEOINFOHEADER описывает растровое изображение и цветовые сведения для видеопотока.
Синтаксис
typedef struct tagKS_VIDEOINFOHEADER {
RECT rcSource;
RECT rcTarget;
DWORD dwBitRate;
DWORD dwBitErrorRate;
REFERENCE_TIME AvgTimePerFrame;
KS_BITMAPINFOHEADER bmiHeader;
} KS_VIDEOINFOHEADER, *PKS_VIDEOINFOHEADER;
Члены
rcSource
Указывает прямоугольник с вырезкой, который выбирает часть активного видеосигнала для использования.
rcTarget
Задает прямоугольник, определяющий целевое окно видео.
dwBitRate
Указывает значение, указывающее приблизительную скорость передачи данных видеопотока в битах в секунду.
dwBitErrorRate
Указывает значение, указывающее частоту ошибок данных видеопотока в битовых ошибках в секунду.
AvgTimePerFrame
Указывает среднее время на кадр в единицах 100-nanosecond.
bmiHeader
Описывает KS_BITMAPINFOHEADER структуру, содержащую сведения о цвете и измерении растрового изображения видео.
Замечания
Чтобы описать видеопоток с параметрами боба или ткать, используйте KS_VIDEOINFOHEADER2.
Структура KS_VIDEOINFOHEADER идентична структуре Microsoft DirectShow VIDEOINFOHEADER.
Исходный фильтр может запросить, чтобы фильтр приемника принимает только раздел видео, предоставляя значения, которые эффективно определяют прямоугольник обрезки в элементе rcSource. Однако если фильтр приемника не проверяет наличие прямоугольника обрезки при подключении, фильтр приемника просто отрисовывает все видео, эффективно игнорируя все данные обрезки, передаваемые из исходного фильтра в фильтр приемника.
В идеале фильтр приемника проверяет rcSource и если фильтр приемника не поддерживает извлечение изображений, а прямоугольник не пустым, то он отклоняет подключение. Фильтр должен использовать функцию Win32 SetRectEmpty для сброса прямоугольника на все нули (и задать IsRectEmpty для последующей проверки прямоугольника).
Элемент rcTarget указывает прямоугольник назначения для видео. Большинство исходных фильтров задают для этого элемента все нули. Нижестоящий фильтр может запросить, чтобы видео было помещено в определенную область буферов, которые он предоставляет. В этом случае он вызывает функцию Win32 QueryAccept с целевым объектом nonempty.
Требования
| Требование | Ценность |
|---|---|
| заголовка | ksmedia.h (include Ksmedia.h) |