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

Статья
08/07/2023

Структура KSCAMERA_EXTENDEDPROP_HEADER — это заголовок полезных данных для свойства расширенного элемента управления.

Синтаксис

typedef struct tagKSCAMERA_EXTENDEDPROP_HEADER {
  ULONG     Version;
  ULONG     PinId;
  ULONG     Size;
  ULONG     Result;
  ULONGLONG Flags;
  ULONGLONG Capability;
} KSCAMERA_EXTENDEDPROP_HEADER, *PKSCAMERA_EXTENDEDPROP_HEADER;

Члены

Version

Номер версии расширенного свойства. Для этого параметра задано значение 1.

PinId

Идентификатор закрепления, соответствующий свойству . Если pinId имеет значение (ULONG)-1, элемент управления применяется к фильтру. В противном случае драйвер камеры должен направить этот элемент управления в соответствующий контакт, когда он будет создан (или если он уже доступен).

Size

Общий размер всех полезных данных в байтах. Сюда входит структура KSCAMERA_EXTENDEDPROP_HEADER и следующие полезные данные, относящиеся к элементу управления.

Result

Для операции set это значение равно 0. Для запросов Result содержит любой код сбоя, который драйвер предоставляет для последней операции управления.

Flags

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

Бит верхнего порядка значения Flags зарезервирован. Этот бит служит флагом отмены и определяется как KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION. Этот флаг имеет смысл только для асинхронных элементов управления.

Capability

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

Определены следующие возможности.

Значение	Описание
KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL	Элемент управления поддерживает асинхронные операции.
KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE	Применяется только к асинхронным элементам управления. Этот флаг помечает операцию управления как отменяемую. Если синхронный элемент управления устанавливает этот флаг, он помечается как недопустимый и не предоставляется приложениям более высокого уровня.

Значение

Описание

KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL

Элемент управления поддерживает асинхронные операции.

KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE

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

Требования

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

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

KSCAMERA_EXTENDEDPROP_VALUE