структура KS_DATARANGE_VIDEO (ksmedia.h)

  • Статья

Структура KS_DATARANGE_VIDEO описывает ряд видеопотоков без параметров bob или плетения.

Синтаксис

typedef struct tagKS_DATARANGE_VIDEO {
  KSDATARANGE                 DataRange;
  BOOL                        bFixedSizeSamples;
  BOOL                        bTemporalCompression;
  DWORD                       StreamDescriptionFlags;
  DWORD                       MemoryAllocationFlags;
  KS_VIDEO_STREAM_CONFIG_CAPS ConfigCaps;
  KS_VIDEOINFOHEADER          VideoInfoHeader;
} KS_DATARANGE_VIDEO, *PKS_DATARANGE_VIDEO;

Члены

DataRange

Задает основной идентификатор формата.

bFixedSizeSamples

Указывает, что все образцы имеют одинаковый размер, если задано значение TRUE.

bTemporalCompression

Указывает, может ли каждый образец стоять отдельно отдельно, не полагаясь на предыдущие или будущие примеры.

StreamDescriptionFlags

Неиспользуемый и должен иметь нулевое значение.

MemoryAllocationFlags

Неиспользуемый и должен иметь нулевое значение.

ConfigCaps

Задает конфигурацию потока, включая масштабирование, обрезку, частоту кадров и данных.

VideoInfoHeader

Указывает сведения о видеопотоке.

Комментарии

Структура KS_DATARANGE_VIDEO используется для двух связанных целей:

  1. Во время инициализации мини-driver возвращает массив KS_DATARANGE_VIDEO структур, которые предоставляют все поддерживаемые форматы для заданного контакта, включая возможные параметры обрезки и масштабирования.
  2. При выборе определенного формата клиентом пользовательского режима члены (и их параметры) этой структуры определяют, поддерживается ли предлагаемый формат мини-накопителем. Клиенты пользовательского режима изменяют содержимое элемента VideoInfoHeader , но должны оставить все остальные члены KS_DATARANGE_VIDEO без изменений. Затем мини-диск проверяет запрошенные параметры и возвращает KS_DATAFORMAT_VIDEO структуру. Затем мини-диск вычисляет элементы, уникальные для конкретного запрошенного формата.
Например, поток, поддерживающий форматы захвата RGB16, RGB24, YVU9 и JPEG, определяет массив из четырех KS_DATAFORMAT_VIDEO структур.

Требования

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

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

KSDATARANGE

KS_VIDEOINFOHEADER

KS_VIDEO_STREAM_CONFIG_CAPS