структура 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 наносекунд.

bmiHeader

Описывает структуру KS_BITMAPINFOHEADER , содержащую сведения о цвете и измерении растрового изображения видео.

Комментарии

Чтобы описать видеопоток с параметрами bob или плетения, используйте KS_VIDEOINFOHEADER2.

Структура KS_VIDEOINFOHEADER идентична структуре Microsoft DirectShow VIDEOINFOHEADER.

Исходный фильтр может запросить, чтобы фильтр приемника принимает только часть видео, предоставляя значения, которые фактически определяют прямоугольник обрезки в элементе rcSource . Однако если фильтр приемника не проверка для прямоугольника обрезки при подключении, фильтр приемника просто отрисовывает все видео, фактически игнорируя любые сведения об обрезке, передаваемые из исходного фильтра в фильтр приемника.

В идеале фильтр приемника проверяет rcSource и, если фильтр приемника не поддерживает извлечение изображений, а прямоугольник не пуст, он отклоняет подключение. Фильтр должен использовать функцию Win32 SetRectEmpty для сброса прямоугольника до всех нулей (и задать для IsRectEmpty значение позже проверка прямоугольника).

Элемент rcTarget задает прямоугольник назначения для видео. Большинство исходных фильтров устанавливают для этого элемента все нули. Нижестоящий фильтр может запросить размещение видео в определенной области буферов, которые он предоставляет. В этом случае он вызывает функцию Win32 QueryAccept с непустимой целью.

Требования

Требование Значение
Заголовок ksmedia.h (включая Ksmedia.h)

См. также раздел

KS_BITMAPINFOHEADER

KS_VIDEOINFOHEADER2