KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTHUMBNAIL

此属性获取或设置相机的缩略图功能。 如果提供了比例系数，则会在所选比例下启用缩略图。

使用情况摘要表

Get	Set	目标	属性描述符类型	属性值类型
是	是	Pin	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

操作数据 (属性值) 包含 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)

另请参阅

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE