KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTHUMBNAIL
此属性获取或设置相机的缩略图功能。 如果提供了比例系数,则会在所选比例下启用缩略图。
使用情况摘要表
Get | Set | 目标 | 属性描述符类型 | 属性值类型 |
---|---|---|---|---|
是 |
是 |
Pin |
操作数据 (属性值) 包含 KSCAMERA_EXTENDEDPROP_HEADER 结构和 KSCAMERA_EXTENDEDPROP_VALUE 结构。 KSCAMERA_EXTENDEDPROP_VALUE是必需的,但 Value 成员将被忽略。
属性数据的总大小为 size 为 (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。 KSCAMERA_EXTENDEDPROP_HEADER 的 Size 成员设置为此总属性数据大小。
KSCAMERA_EXTENDEDPROP_HEADER 的 Capability 成员包含支持的以下一个或多个缩放值的按位 OR 组合。
缩略图缩放标志 | 说明 |
---|---|
KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_DISABLE | 缩略图处于禁用状态。 |
KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_2X | 缩略图分辨率为 X/2 和 Y/2。 |
KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_2X | 缩略图分辨率为 X/4 和 Y/4。 |
KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_8X | 缩略图分辨率为 X/8 和 Y/8。 |
KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_16X | 缩略图分辨率为 X/16 和 Y/16。 |
KSCAMERA_EXTENDEDPROP_HEADER 的 Flags 成员包含当前为相机设置的缩略图比例值。 如果未启用缩略图生成,则在 “标志”中仅设置KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_DISABLE。
此属性控件是异步的,不可取消。
注解
获取 属性
响应KSPROPERTY_TYPE_GET请求时,驱动程序会将 KSCAMERA_EXTENDEDPROP_HEADER 的成员设置为以下内容。
成员 | Value |
---|---|
版本 | 1 |
PinId | 照片图钉的固定 ID。 |
大小 | sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) |
结果 | 尝试获取缩略图设置时产生的错误值。 |
功能 | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | () 支持的缩略图刻度值。 |
Flags | 当前缩略图值设置 () 一个值。 |
设置 属性
设置 属性时,KSPROPERTY_TYPE_SET请求,KSCAMERA_EXTENDEDPROP_HEADER的 Flags 成员将包含缩略图缩放标志之一。
要求
版本 |
从Windows 8.1开始可用。 |
标头 |
Ksmedia.h (包括 Ksmedia.h) |