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

  • Статья

Указывает операцию управления камерой, включая настройку вспышки, свойств элемента управления закрепления изображения, интересующую область изображения или стабилизацию видео. Эта структура описывает свойства на основе фильтра в наборе свойств 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 требуемый параметр для указанного свойства из перечисленных ниже значений. Этот элемент может быть битовой или из следующих значений, определенных в 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

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

FocusRect

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

Комментарии

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

Требования

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

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

KSEVENT_CAMERACONTROL

KSPROPERTY

KSPROPERTY_CAMERACONTROL_FLASH_S

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S

KSPROPERTY_CAMERACONTROL_VIDEOSTABILIZATION_MODE_S

RECT