KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA

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

使用情况摘要表

范围 控制 类型

版本 1

Pin

同步

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

#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

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

大小

它必须是 (KSCAMERA_EXTENDEDPROP_HEADER) +sizeof (KSCAMERA_EXTENDEDPROP_METADATAINFO)

结果

这表示最后一个 SET 操作的错误结果。 如果未执行 SET 操作,则它必须为 0。

功能

这未使用,并且必须为 0。

Flags

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

要求

标头

Ksmedia.h