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_HEADERSize 成员设置为此总属性数据大小。

KSCAMERA_EXTENDEDPROP_HEADERCapability 成员包含支持的以下一个或多个缩放值的按位 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_HEADERFlags 成员包含当前为相机设置的缩略图比例值。 如果未启用缩略图生成,则在 “标志”中仅设置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_HEADERFlags 成员将包含缩略图缩放标志之一。

要求

版本

从Windows 8.1开始可用。

标头

Ksmedia.h (包括 Ksmedia.h)

另请参阅

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE