Наборы свойств мини-driver для захвата видео
В этом разделе описываются наборы свойств для захвата видео, доступные для мини-накопителей видео, использующих службы потоковой передачи ядра WDM в Microsoft Windows XP, Windows 2000, Windows 98/Me и более поздних операционных системах.
Страница ссылок для каждого свойства содержит таблицу со следующими заголовками столбцов.
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
Эти заголовки имеют следующие значения:
Get
Поддерживает ли целевой объект KS запрос свойства KSPROPERTY_TYPE_GET?
Set
Поддерживает ли целевой объект KS запрос свойства KSPROPERTY_TYPE_SET?
Целевой объект
Целевой объект — это объект KS, в который отправляется запрос на свойство. Целевым объектом для свойства захвата видео является фильтр или булавка. (Запрос свойства указывает целевой объект с помощью дескриптора ядра.)
Тип дескриптора свойства
Дескриптор свойства указывает свойство и операцию, выполняемую с этим свойством. Дескриптор всегда начинается со структуры KSPROPERTY , но некоторые типы дескриптора содержат дополнительные сведения. Например, структура KSNODEPROPERTY — это дескриптор свойства, который начинается со структуры KSPROPERTY, но также включает идентификатор узла.
Тип значения свойства
Свойство имеет значение, и тип этого значения зависит от свойства . Например, свойство, которое может находиться только в одном из двух состояний ( on или off), обычно имеет значение BOOL. Свойство, которое может принимать целочисленные значения от 0x0 до 0xFFFFFFFF, может иметь значение ULONG. Более сложные свойства могут иметь значения, которые являются массивами или структурами.
Приведенные выше дескриптор свойства и значение свойства являются версиями спецификаций экземпляров и буферов данных операций, которые обсуждаются в KS Properties, Events и Methods .
Запрос свойства использует один из следующих флагов для указания операции, выполняемой с свойством :
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
Все объекты фильтра и закрепления поддерживают операцию базовой поддержки для своих свойств. Поддерживают ли они операции get и Set , зависит от свойства . Свойство, представляющее неотъемлемую возможность объекта фильтра или закрепления, скорее всего, потребует только операции получения. Для свойства, представляющего настраиваемый параметр, может потребоваться только операция Set , хотя операция get также может быть полезна для чтения текущего параметра. Дополнительные сведения об использовании операций получения, задания и базовой поддержки со свойствами захвата видео см. в разделе Свойства KS.
Каждое описание свойства содержит таблицу, показывающую, должны ли мини-устройства захвата видео поддерживать чтение или запись свойства. Мини-видеоприводы должны возвращать STATUS_NOT_SUPPORTED в ответ на запросы на получение или задание свойств, которые не поддерживаются мини-накопителем.
В следующем списке описаны наборы свойств потоковой передачи ядра, которые используются мини-драйверами захвата видео.
PROPSETID_VIDCAP_CAMERACONTROL
KSPROPERTYSETID_ExtendedCameraControl
PROPSETID_VIDCAP_DROPPEDFRAMES
PROPSETID_VIDCAP_VIDEOCOMPRESSION
С драйвером класса ВИДЕО USB можно использовать следующие наборы свойств:
PROPSETID_VIDCAP_CAMERACONTROL