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)