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

Статья
02/07/2025

Указывает операцию управления камерой, включая настройку вспышки, свойства элемента управления закреплением изображения, область интереса к изображению или стабилизацию видео. Эта структура описывает свойства на основе фильтров в наборе свойств PROPSETID_VIDCAP_CAMERACONTROL.

Поддерживается начиная с Windows 8.

Синтаксис

typedef struct {
  KSPROPERTY Property;
  LONG       Value;
  ULONG      Flags;
  ULONG      Capabilities;
  RECT       FocusRect;
} KSPROPERTY_CAMERACONTROL_S_EX, *PKSPROPERTY_CAMERACONTROL_S_EX;

Члены

Property

Указывает инициализированную структуру KSPROPERTY, описывающую набор свойств, идентификатор свойства и тип запроса.

Value

Указывает значение свойства. Этот элемент является чтением и записью.

Flags

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

Ценность	Описание
KSPROPERTY_CAMERACONTROL_FLAGS_AUTO	Указывает, что параметр управляется автоматически. Если драйвер получает это значение, он должен установить элемент управления камеры синхронно в автоматический режим, а затем вернуться.
KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL	Указывает, что параметр управляется вручную. Если драйвер получает это значение, он должен установить элемент управления камеры синхронно в режим вручную, а затем вернуться.
KSPROPERTY_CAMERACONTROL_FLAGS_ASYNCHRONOUS	Указывает, должен ли драйвер выполнять операцию управления камерой асинхронно, где приложение выпустило команду для драйвера, чтобы настроить параметры управления камерой заранее после получения изображения. Этот флаг должен быть задан только в том случае, если заданы KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL или KSPROPERTY_CAMERACONTROL_FLAGS_AUTO. Если это значение флага и значение флага KSPROPERTY_CAMERACONTROL_FLAGS_AUTO задано, драйвер должен инициировать рабочий поток, чтобы запустить одну запрошенную операцию управления и отклонить все остальные запросы для той же операции, пока она не завершит первую. После успешного завершения операции драйвер должен активировать событие KSEVENTSETID_CameraAsyncControl.

Capabilities

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

FocusRect

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

Замечания

Когда запрошенная операция фокусировки камеры завершена или отменена, драйвер должен создать событие, указанное значением перечисления KSEVENT_CAMERACONTROL_FOCUS.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
минимальный поддерживаемый сервер	Windows Server 2012
заголовка	ksmedia.h (include Ksmedia.h)

См. также

KSEVENT_CAMERACONTROL

KSPROPERTY

KSPROPERTY_CAMERACONTROL_FLASH_S

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S

KSPROPERTY_CAMERACONTROL_VIDEOSTABILIZATION_MODE_S

RECT

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