KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM

  • Статья

KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM — это идентификатор свойства, который будет использоваться для управления метаданными гистограммы, созданными драйвером. Это элемент управления уровня закрепления только для предварительного просмотра.

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

Область Control Тип

версия 1

Pin

Синхронная

В KSCAMERA_EXTENDEDPROP_HEADER можно разместить следующие флаги . Поле Flags для управления метаданными гистограммы в драйвере. Значение по умолчанию — HISTOGRAM_OFF.

#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_OFF      0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_HISTOGRAM_ON       0x0000000000000001

Этот элемент управления необходимо использовать перед элементом управления KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA , чтобы обеспечить выделение буфера метаданных надлежащего размера.

Если задано значение HISTOGRAM_OFF, драйвер не должен доставлять метаданные гистограммы в контакте предварительного просмотра. Драйвер не должен включать размер метаданных гистограммы в требование к размеру буфера метаданных.

Если задано значение HISTOGRAM_ON, драйвер должен доставить метаданные гистограммы в контакт предварительного просмотра. Драйвер должен включать размер метаданных гистограммы в требование к размеру буфера метаданных.

Если драйвер не имеет возможности создавать метаданные гистограммы, драйвер не должен реализовывать этот элемент управления. Если драйвер поддерживает этот элемент управления, он также должен поддерживать KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA элемент управления.

Вызов SET этого элемента управления не оказывает никакого влияния, если контакт предварительного просмотра находится в состоянии, превышающем KSSTATE_STOP. Драйвер должен отклонить полученный вызов SET , если предварительная версия не находится в состоянии остановки и возвращает STATUS_INVALID_DEVICE_STATE. В вызове GET драйвер должен вернуть текущие параметры в поле Флаги .

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

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

Версия

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

PinId

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

Размер

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

Результат

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

Функция

Должно быть равно 0.

Флаги

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

Требования

Заголовок

 Ksmedia.h