KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA

  • Статья

Этот расширенный элемент управления свойствами используется клиентом для запроса к драйверу требований к буферу метаданных. Он отправляется драйверу вместе со стандартной структурой KSCAMERA_EXTENDEDPROP_HEADER , за которой следует структура KSCAMERA_EXTENDEDPROP_METADATAINFO .

Сводная таблица использования

Область Control Тип

версия 1

Pin

Синхронная

Ниже приведены флаги метаданных, которые можно поместить в KSCAMERA_EXTENDEDPROP_HEADER. Поле Флаги .

#define KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY                     0x0000000000000001  
#define KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED                0x0000000000000100

В вызове Get драйвер выполняет следующие действия:

  1. Заполняет KSCAMERA_EXTENDEDPROP_HEADER. Возможность с 0.

  2. Заполните KSCAMERA_EXTENDEDPROP_HEADER. Флаги с сочетанием любого из указанных выше флагов KSCAMERA_EXTENDEDPROP_METADATA_XXX для указания требований к памяти метаданных.

  3. Заполнение KSCAMERA_EXTENDEDPROP_METADATAINFO. BufferAlignment с требуемым выравниванием памяти (KSCAMERA_EXTENDEDPROP_MetadataAlignment_Xxx). Возможные значения см. в KSCAMERA_EXTENDEDPROP_MetadataAlignment .

  4. Заполните KSCAMERA_EXTENDEDPROP_METADATAINFO. MaxMetadataBufferSize с требуемым размером буфера метаданных в байтах.

В таблице ниже приведены описания и требования к полям структуры KSCAMERA_EXTENDEDPROP_HEADER при использовании элемента управления метаданными.

Член Описание

Версия

Значение должно быть 1.

PinId

Это должен быть идентификатор пин-кода, связанный с закреплением, фрейм которого содержит метаданные. Это может быть любой из предварительных просмотров, записей и закреплений изображения.

Размер

Это должно быть значение sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_METADATAINFO).

Результат

Это указывает на результаты последней операции SET. Если операция SET не выполнена, это должно быть 0.

Функция

Этот параметр не используется и должен иметь значение 0.

Флаги

Это поле для чтения и записи. Это может быть любое сочетание KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED или KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY.

Требования

Заголовок

 Ksmedia.h