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

Статья
02/07/2025

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

Синтаксис

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 используется для двух связанных целей:

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

Например, поток, поддерживающий форматы записи RGB16, RGB24, YVU9 и JPEG, определяет массив из четырех структур KS_DATAFORMAT_VIDEO.

Требования

Требование	Ценность
заголовка	ksmedia.h (include Ksmedia.h)

См. также

KSDATARANGE

KS_VIDEOINFOHEADER

KS_VIDEO_STREAM_CONFIG_CAPS

Поделиться через