KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION

  • 项目

KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION 是一个属性 ID，用于通知驱动程序相机是否面向应用程序的活动显示。 设置新的 WinRT API 属性 PanelBasedOptimizationControl.Panel 时，Windows 将设置该属性。

可在 GitHub 上的 AVStream 相机示例驱动程序 中找到设置 KSProperty 控件的示例。

使用情况摘要表

获取 设置 目标 属性描述符类型 属性值类型
是 是 筛选器 KSPROPERTY KSCAMERA_EXTENDEDPROP_HEADER

注解

属性请求包含 KSCAMERA_EXTENDEDPROP_HEADER 结构和 KSCAMERA_EXTENDEDPROP_VALUE 结构。

总属性数据大小为 sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)。

KSCAMERA_EXTENDEDPROP_HEADER的 Size 成员设置为此总属性数据大小。

下面是可以放置在KSCAMERA_EXTENDEDPROP_HEADER中的标志 。标志 和 KSCAMERA_EXTENDEDPROP_HEADER。功能 字段。

相对面板优化模式 说明
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF 相机将使用正常操作模式
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON 相机将使用相对于值字段中描述的位置的优化
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC 可以在流式传输时动态调整相机位置提示，而不会干扰流

KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION 始终是同步控件。

任何应用都可以读取 属性，但只有已打开相机进行独占访问的应用才能写入 属性值。

如果在没有独占模式访问权限的情况下尝试写入属性，将返回合适的错误代码。

关于将此 DDI 映射到 PanelBasedOptimizationControl，使用 PanelBasedOptimizationControl 的应用程序将设置 Panel 值，Windows 将在内部使用该值对有效负载 的KSCAMERA_EXTENDEDPROP_VALUE 字段进行编程。

“功能和标志”字段将由 Windows 控制。

如果驱动程序在相机设备流式传输时收到 SET 操作，并且未设置 KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC* 标志，则驱动程序将返回基于状态的错误。

下表包含使用元数据控件时 KSCAMERA_EXTENDEDPROP_HEADER 结构字段的要求。

成员 说明
版本 这必须为 1。
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
大小 这必须为 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE)
结果 指示上次 SET 操作的错误结果。 如果未发生 SET 操作，则必须为 0。
功能 必须是上面定义的受支持KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_XXX标志的按位或。
Flags 这是一个读/写字段。 这可以是 上面定义的KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON 标志或 KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF 标志。

如果在 KSCAMERA_EXTENDEDPROP_HEADER 的 “标志 ”字段中指定 了KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON，则 Value.ul 字段必须为相机当前面向的相对方向指定 PLD。

这可以是 ACPI PLD 的任何枚举值，但最常见的是 Front、 Back 或 Unknown。

如果指定 了 KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF ，则对于 SET 操作，将忽略 Value 字段。

对于 GET 操作，驱动程序必须返回相机当前编程的方向。

如果指定 了KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF ，或者未设置任何值，则必须返回设备的默认 PLD。

如果指定 了KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON ，则必须返回最近设置的值。

要求

标头： ksmedia.h (包括 Ksmedia.h)