KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE (режим, определенный драйвером)
Свойство режима сцены выбирает определенный драйвером режим, который представляет коллекцию предустановленных элементов управления. Драйвер определяет предустановки, назначенные режиму сцены, и включает эти параметры управления при выборе сцены.
Сводная таблица использования
| Get | Set | целевого объекта | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
| Да | Да | Фильтр | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
Значение свойства (данные операции) содержит структуру KSCAMERA_EXTENDEDPROP_HEADER и структуру KSCAMERA_EXTENDEDPROP_VALUE . KSCAMERA_EXTENDEDPROP_VALUE является обязательным, но элемент Value игнорируется.
Общий размер данных свойства равен sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). Элементу SizeKSCAMERA_EXTENDEDPROP_HEADER присваивается этот общий размер данных свойства.
Элемент CapabilityKSCAMERA_EXTENDEDPROP_HEADER содержит побитовую комбинацию ИЛИ одного или нескольких из следующих режимов сцены, поддерживаемых драйвером.
| Режим сцены | Описание |
|---|---|
| KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO | Автоматический режим запаха. Элементы управления находятся в автоматических настройках. |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_MACRO | Режим макрос-сцены (драйвер определен). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_PORTRAIT | Режим книжной сцены (драйвер определен). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SPORT | Режим спортивной сцены (драйвер определен). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SNOW | Режим снежной сцены (драйвер определен). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHT | Режим ночной сцены (драйвер определен). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_BEACH | Режим пляжной сцены (определяется драйвером). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SUNSET | Режим сцены заката (определяется драйвером). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_CANDLELIGHT | Режим сцены при свечах (драйвер определен). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_LANDSCAPE | Режим альбомной сцены (определяется драйвером). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHTPORTRAIT | Ночной режим книжной сцены (определяется драйвером). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_BACKLIT | Режим сцены с подсветкой (драйвер определен). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_MANUAL | Элементы управления изменяются вручную, и не задаются предопределенные режимы сцены. |
Элемент FlagsKSCAMERA_EXTENDEDPROP_HEADER содержит режим сцены, заданный в данный момент для камеры. Режим сцены по умолчанию для камеры всегда KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO.
Этот элемент управления свойством является асинхронным и не может быть отменен.
Комментарии
Получение свойства
При ответе на запрос KSPROPERTY_TYPE_GET драйвер задает членам KSCAMERA_EXTENDEDPROP_HEADER следующее.
| Член | Значение |
|---|---|
| Версия | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Размер | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Результат | 0 |
| Функция | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | (поддерживаются значения режима сцены) |
| Флаги | Значение текущего режима сцены (только одно значение) |
Если ранее не был задан режим сцены, то параметру Flags присваивается значение KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO (по умолчанию).
Задание свойства
Если свойство задано, запрос KSPROPERTY_TYPE_SET элемент Flags KSCAMERA_EXTENDEDPROP_HEADER будет содержать режим сцены для включения.
Требования
Версия: Доступно, начиная с Windows 8.1
Заголовка: Ksmedia.h (включая Ksmedia.h)