KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA

  • 项目

客户端使用此扩展属性控件来查询驱动程序的元数据缓冲区要求。 它随标准 KSCAMERA_EXTENDEDPROP_HEADER 结构以及 KSCAMERA_EXTENDEDPROP_METADATAINFO 结构一起发送到驱动程序。

使用情况摘要表

范围 控制 类型

版本 1

Pin

同步

下面是可以放置在KSCAMERA_EXTENDEDPROP_HEADER中的元数据标志 。标志 字段。

#define KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY                     0x0000000000000001  
#define KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED                0x0000000000000100

在 Get 调用中，驱动程序执行以下操作：

  1. 填充 KSCAMERA_EXTENDEDPROP_HEADER。具有 0 的功能 。

  2. 填充KSCAMERA_EXTENDEDPROP_HEADER。上述任何标志的组合KSCAMERA_EXTENDEDPROP_METADATA_XXX 标志，以指示元数据内存要求。

  3. 填充KSCAMERA_EXTENDEDPROP_METADATAINFO。具有所需内存对齐方式的 BufferAlignment (KSCAMERA_EXTENDEDPROP_MetadataAlignment_ Xxx) 。 有关可能的值，请参阅 KSCAMERA_EXTENDEDPROP_MetadataAlignment 。

  4. 填充 KSCAMERA_EXTENDEDPROP_METADATAINFO。MaxMetadataBufferSize ，所需元数据缓冲区大小（以字节为单位）。

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

成员 说明

版本

此值必须为 1。

PinId

这必须是与其帧包含元数据的图钉关联的固定 ID。 这可以是任何预览、记录和图像固定。

大小

这必须是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) +sizeof (KSCAMERA_EXTENDEDPROP_METADATAINFO) ，

结果

这表示上次 SET 操作的错误结果。 如果未执行 SET 操作，则必须为 0。

功能

这是未使用的，必须为 0。

Flags

这是一个读/写字段。 这可以是 KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED 或KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY的任意组合。

要求

标头

 Ksmedia.h