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

  • Статья

Описывает свойства элемента управления для интересующей области (ROI) в наборе свойств элемента управления камерой PROPSETID_VIDCAP_CAMERACONTROL_REGION_OF_INTEREST . Интересующая область представляет собой прямоугольник на изображении, который используется для фокусировки камеры. Эта структура задает значения свойств, которые используются в запросах к драйверу камеры.

Синтаксис

typedef struct {
  RECT  FocusRect;
  BOOL  AutoFocusLock;
  BOOL  AutoExposureLock;
  BOOL  AutoWhitebalanceLock;
  union {
    ULONG Capabilities;
    ULONG Configuration;
  };
} KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S, *PKSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S;

Члены

FocusRect

Структура RECT , задающая прямоугольную область, в которой устройство должно задать фокус. Эта структура доступна только для приложений Windows.

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

Координаты прямоугольника соответствуют разрешению предварительного просмотра видео.

AutoFocusLock

Если задано значение TRUE, устройство должно заблокировать фокус на текущем значении.

Этот элемент следует игнорировать, если FocusRect не является допустимым значением.

AutoExposureLock

Если задано значение TRUE, устройство должно заблокировать доступ к текущему значению.

Этот элемент следует игнорировать, если FocusRect не является допустимым значением.

AutoWhitebalanceLock

Если задано значение TRUE, устройство должно заблокировать для параметра баланса белого текущее значение.

Этот элемент следует игнорировать, если FocusRect не является допустимым значением.

Capabilities

Указывает, поддерживает ли устройство и драйвер настройку интересующей области автоматически или вручную. Этот член побитовое ИЛИ следующих возможных значений:

Значение Значение
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_AUTO Устройство и драйвер могут автоматически задать интересующую область.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_MANUAL Пользователь может вручную задать интересующую область.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_ASYNC Функции управления рентабельности инвестиций выполняются асинхронно. Эта возможность доступна начиная с Windows 8.1.

Configuration

Флаги конфигурации для операций управления для региона. Это побитовая комбинация ИЛИ следующих значений.

Этот элемент доступен начиная с Windows 8.1.

Значение Значение
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_FOCUS Настройка автоматического фокуса для региона.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_EXPOSURE Настройка автоматической экспозиции для региона.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_WB Установите автоматический баланс белого для региона.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONVERGEMODE Включение конвергенции объектов в регионе.

Требования

Требование Значение
Минимальная версия клиента Windows 8
Минимальная версия сервера Windows Server 2012
Верхняя часть ksmedia.h (включая Ksmedia.h)

См. также раздел

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY

RECT