KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW

项目
06/15/2023

KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW 是一个属性 ID，用于指定相机流式传输时相机的视野和缩放。

此控件可能替代平移、倾斜和缩放。此控件仅在相机主动流式传输时适用。要主动流式传输，则意味着预览或录制固定针必须 处于KSSTATE_RUN、准备就绪且能够传送帧。

在 SET 上，如果流未处于活动状态，则此控件将返回 STATUS_INVALID_DEVICE_STATE。

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

使用情况摘要表

范围	控制	类型
版本 1	筛选器	同步

以下位标志控制驱动程序中的属性 ID：

#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING    0x0000000000000001

功能说明

以下标志可以放在 KSCAMERA_EXTENDEDPROP_HEADER中。标志 和 KSCAMERA_EXTENDEDPROP_HEADER。功能 字段。

标志	描述
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL	数字窗口由应用程序手动控制。
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING	相机会自动调整数字窗口，以将焦点聚焦在视图中的主导人脸上。

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW 始终是同步控件。

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

成员	说明
版本	必须为 1。
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
大小	必须是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING)
结果	必须包含 0。此字段仅用于返回上次异步 SET 操作的结果。
功能	必须支持KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL。可以选择性地支持KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING。
Flags	必须是KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL或KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING。

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

如果在“标志”字段中设置了KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING，则这些参数是只读的。如果在 SET 操作期间设置了KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING，则忽略以下参数。

参数	说明
OriginX	数字窗口沿 X 轴的原点，采用 Q24 格式。必须默认为 0。 OriginX 不能小于 PorchLeft，也不得大于 PorchRight – WindowSize。
OriginY	数字窗口沿 X 轴的原点，采用 Q24 格式。必须默认为 0。 OriginX 不能小于 PorchLeft，也不得大于 PorchRight – WindowSize。
WindowSize	Q24 格式沿两个轴的数字窗口的大小。这是沿 x 轴和 y 轴可见的完整视图的分数。在 Q24) 中，WindowSize 必须默认为 1.0 0x01000000 (。 WindowSize 不能小于 MinWindowSize，也不能大于 MaxWindowSize。此外，WindowSize 加 OriginX 不能大于 PorchRight;WindowsSize 加 OriginY 不能大于 PorchBottom。
预留	设置为 0。