Поделиться через

структура 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

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

Ценность Значение
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_AUTO Устройство и драйвер могут автоматически задать интересующий регион.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_MANUAL Пользователь может вручную задать интересующий регион.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_ASYNC Функции управления roI выполняются асинхронно. Эта возможность доступна начиная с 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 (include Ksmedia.h)

См. также

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY

RECT