KSPROPERTY_CAMERACONTROL_ZOOM_RELATIVE
KSPROPERTY_CAMERACONTROL_ZOOM_RELATIVE 属性指定相机的缩放状态。
使用情况摘要表
| 获取 | 设置 | 目标 | 属性描述符类型 | 属性值类型 |
|---|---|---|---|---|
| 是 | 是 | 筛选器或节点 | KSPROPERTY_CAMERACONTROL_S 或 KSPROPERTY_CAMERACONTROL_NODE_S | LONG |
属性值 (操作数据) 是一个 LONG，用于指定相机的相对缩放设置。 值的大小表示所需的缩放速度;值越大，表示速度越高。
| 值 | 说明 |
|---|---|
| 0 | 停止缩放镜头运动。 |
| 正值 | 开始向远摄方向移动缩放镜头 (启动放大) 。 |
| 负值 | 开始以广角方向移动缩放镜头 (启动缩小) 。 |
注解
KSPROPERTY_CAMERACONTROL_NODE_S 结构的 Value 成员指定相对缩放。
请注意，特定设备可能仅支持特定的速度范围。 若要确定设备支持的速度范围，应用程序可以发出 KSPROPERTY_TYPE_BASICSUPPORT 请求。 可以在 KSPROPERTY_ITEM 结构的 Flags 成员中指定 KSPROPERTY_TYPE_BASICSUPPORT 。
某些设备仅支持单个缩放速度。 在这种情况下， Value 成员的符号指示镜头是应放大还是缩小。
发出设置请求时，客户端应在 KSPROPERTY_CAMERACONTROL_NODE_S 结构的 Value 成员中提供上表中的值之一。
发出获取请求时，客户端会收到上表中KSPROPERTY_CAMERACONTROL_NODE_S结构的 Value 成员中的值之一。 该值指示相机的当前缩放状态。
要求
标头： ksmedia.h (包括 Ksmedia.h)