Наборы свойств Minidriver для записи видео

В этом разделе описаны наборы свойств для отслеживания видео, доступные для мини-driver для видеозахвата, использующих службы потоковой передачи ядра WDM в Microsoft Windows XP, Windows 2000 и Windows 98/Me и более поздних операционных системах.

Эталонная страница для каждого свойства содержит таблицу со следующими заголовками столбцов.

Эти заголовки имеют следующие значения:

• Get

  Поддерживает ли целевой объект KS запрос свойства KSPROPERTY_TYPE_GET?

• Set

  Поддерживает ли целевой объект KS запрос свойства KSPROPERTY_TYPE_SET?

• Target

  Целевой объект — это объект KS, в который отправляется запрос на свойство. Целевой объект для свойства захвата видео — фильтр или закрепление. (Запрос свойства указывает целевой объект дескриптором ядра.)

• Тип дескриптора свойства

  Дескриптор свойства указывает свойство и операцию, выполняемую для этого свойства. The descriptor always begins with a KSPROPERTY structure, but some types of descriptor contain additional information. For example, the KSNODEPROPERTY structure is a property descriptor that begins with a KSPROPERTY structure but also includes a node identifier.

• Тип значения свойства

  Свойство имеет значение, а тип этого значения зависит от свойства. Например, свойство, которое может находиться только в одном из двух состояний-включено или отключено, обычно имеет значение BOOL. Свойство, которое может принимать целые значения от 0x0 до 0xFFFFFFFF, может иметь значение ULONG. Более сложные свойства могут иметь значения, которые являются массивами или структурами.

Описанные выше дескрипторы свойств и значения свойств являются версиями буферов спецификации экземпляра и данных операций, которые обсуждаются KS Properties, Events и Methods .

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

• KSPROPERTY_TYPE_BASICSUPPORT

• KSPROPERTY_TYPE_GET

• KSPROPERTY_TYPE_SET

Все объекты фильтра и закрепления поддерживают операцию базовой поддержки для их свойств. Whether they support the get and Set operations depends on the property. Свойство, представляющее неотъемлемую возможность фильтра или закрепленного объекта, скорее всего, потребует только операции получения. A property that represents a configurable setting might require only a Set operation, although a get operation might also be useful for reading the current setting. For more information about using the get, set, and basic-support operations with video capture properties, see KS Properties.

Каждое описание свойства содержит таблицу, которая указывает, должны ли мини-накопители записи видео поддерживать чтение или запись свойства. Мини-накопительные видеоснимки должны возвращать STATUS_NOT_SUPPORTED в ответ на получение или задание запросов на свойства, которые не поддерживаются мини-driver.

В следующем списке описаны наборы свойств потоковой передачи ядра, которые используют мини-drivers для записи видео:

PROPSETID_ALLOCATOR_CONTROL

PROPSETID_EXT_DEVICE

PROPSETID_EXT_TRANSPORT

PROPSETID_TIMECODE_READER

PROPSETID_TUNER

PROPSETID_VIDCAP_CAMERACONTROL

KSPROPERTYSETID_ExtendedCameraControl

PROPSETID_VIDCAP_CROSSBAR

PROPSETID_VIDCAP_DROPPEDFRAMES

PROPSETID_VIDCAP_TVAUDIO

PROPSETID_VIDCAP_VIDEOCOMPRESSION

PROPSETID_VIDCAP_VIDEOCONTROL

PROPSETID_VIDCAP_VIDEODECODER

PROPSETID_VIDCAP_VIDEOPROCAMP

Следующие наборы свойств можно использовать с драйвером класса ВИДЕО USB:

PROPSETID_VIDCAP_CAMERACONTROL

KSPROPERTYSETID_ExtendedCameraControl

PROPSETID_VIDCAP_VIDEOPROCAMP

PROPSETID_VIDCAP_SELECTOR