KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION

KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION — это идентификатор свойства, используемый для информирования водителя о том, обращена ли камера спереди относительно активного дисплея приложения. Windows задаст свойство при установке нового свойства API WinRT PanelBasedOptimizationControl.Panel.

Примеры настройки элементов управления KSProperty можно найти в примере драйвера камеры AVStream на сайте GitHub.

Сводная таблица использования

Получить	Присвойте параметру	Назначение	Тип дескриптора свойства	Тип значения свойства
Да	Да	Фильтр	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

Комментарии

Запрос свойства содержит структуру KSCAMERA_EXTENDEDPROP_HEADER и структуру KSCAMERA_EXTENDEDPROP_VALUE .

Общий размер данных свойства равен sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE).

Элементу SizeKSCAMERA_EXTENDEDPROP_HEADER присвоен общий размер данных свойства.

Ниже приведены флаги, которые можно поместить в KSCAMERA_EXTENDEDPROP_HEADER. Флаги и KSCAMERA_EXTENDEDPROP_HEADER. Поля возможностей .

Режим оптимизации относительной панели	Описание
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF	Камера будет использовать обычный режим работы
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON	Камера будет использовать оптимизацию относительно позиции, описанной в поле значения
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC	Указание о расположении камеры можно динамически настраивать во время потоковой передачи без сбоя потока

KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION всегда является синхронным элементом управления.

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

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

Что касается сопоставления этого DDI с PanelBasedOptimizationControl, приложение, использующее PanelBasedOptimizationControl, задаст значение Panel, которое Windows будет использовать для программирования поля KSCAMERA_EXTENDEDPROP_VALUE полезных данных.

Поле Возможности и флаги будет управляться Windows.

Если драйвер получает операцию SET во время потоковой передачи устройства камеры и флаг KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC* не установлен, драйвер возвращает ошибку на основе состояния.

В следующей таблице приведены требования к полям структуры KSCAMERA_EXTENDEDPROP_HEADER при использовании элемента управления метаданными.

Член	Описание
Версия	Это значение должно быть 1.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Размер	Это должны быть значения sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
Результат	Указывает результаты ошибки последней операции SET. Если операция SET не выполнена, это значение должно быть равным 0.
Функция	Должен быть немного мудр или поддерживаемых флагов KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_XXX , определенных выше.
Флаги	Это поле для чтения и записи. Это могут быть флаги KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON или KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF , определенные выше.

Если KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON указано в поле ФлагиKSCAMERA_EXTENDEDPROP_HEADER, в поле Value.ul необходимо указать PLD для относительного направления, в которое в данный момент обращена камера.

Это может быть любое из значений перечисления для ACPI PLD, но чаще всего это будет Front, Back или Unknown.

Если указано KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF , для операций SET поле Значение игнорируется.

Для операций GET драйвер должен вернуть направление, на которое в данный момент запрограммирована камера.

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

Если указан KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON , необходимо вернуть последнее заданное значение.

Требования

Заголовок: ksmedia.h (включая Ksmedia.h)