KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE

  • 项目

客户端使用此扩展属性控制来控制 IR 相机的红外火炬的功率水平和占空比。 它随标准KSCAMERA_EXTENDEDPROP_HEADER结构一起发送到驱动程序 ， 后跟 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 结构。

使用情况摘要表

Get Set 目标 属性描述符类型 属性值类型
是 是 筛选器 KSPROPERTY KSCAMERA_EXTENDEDPROP_HEADER

注解

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

总属性数据大小为 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) 。 KSCAMERA_EXTENDEDPROP_HEADER的 Size 成员设置为此总属性数据大小。

下面是可以放置在KSCAMERA_EXTENDEDPROP_HEADER中的标志 。标志 和 KSCAMERA_EXTENDEDPROP_HEADER。功能 字段。 它们定义 IR 火炬的操作模式 () 。

火炬模式 说明
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF 关
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON Always On
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATING_FRAME_ILLUMINATION 对于其他每个帧，打开

KSCAMERA_EXTENDEDPROP_IRTORCHMODE始终是同步控件。 当相机不进行流式处理时，控件没有定义的行为。

对于 GET 请求，驱动程序设置以下字段：

  • KSCAMERA_EXTENDEDPROP_HEADER。具有上述 位掩码的功能KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX 标志表示相机支持的操作模式。
  • KSCAMERA_EXTENDEDPROP_HEADER。标志 到上述KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX 标志之一，以指示当前操作模式。
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING。模式 为 0。
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING。最小 到可用最低功率级别。
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING。最大 到可用最大功率级别。
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING。单步 到功率级别之间的最小增量。
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING。VideoProc.ul 到当前功率级别。 此值应默认为人脸身份验证控件通常使用的相同功率级别。

对于 SET 请求，驱动程序使用以下字段：

  • KSCAMERA_EXTENDEDPROP_HEADER。 用于设置操作模式的标志。
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING。VideoProc.ul 设置功率级别。 此值对KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF没有影响。

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

成员 说明

版本

这必须为 1。

PinId

KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) 。

大小

这必须为 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) +sizeof ([KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING] (/windows-hardware/drivers/ddi/ksmedia/ns-ksmedia-tagkscamera_extendedprop_videoprocsetting) ) ，

结果

对于同步控件，将忽略此值。

功能

可以是 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF、 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON 或 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION的任意组合。 此字段必须报告至少一个功能。 字段必须报告 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON 或 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION 或同时报告两者。 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF值是可选的。

Flags

必须是功能中报告的标志之一。 默认值必须为 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON 或 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION。

下表包含使用 IR 火炬模式控件时 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 结构字段的说明和要求。

成员 说明

“模式”

未使用。 必须为 0。

Min/Max/Step

Min/Max/Step 包含 IR 功率设置的最小值/最大值/增量。 驱动程序必须返回 GET 操作的这些值。 (Max - 最小) 必须按步整。 步骤不能为零 (0) 。

VideoProc

对于 SET 操作，VideoProc.Value.ul 必须在 Min/Max/Step 参数描述的范围内指定功率级别。 对于 GET 操作，驱动程序必须返回当前功率级别。

预留

未使用。 驱动程序必须忽略。

要求

标头

 Ksmedia.h