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 调用中,驱动程序执行以下操作:
填充 KSCAMERA_EXTENDEDPROP_HEADER。具有 0 的功能 。
填充KSCAMERA_EXTENDEDPROP_HEADER。上述任何标志的组合KSCAMERA_EXTENDEDPROP_METADATA_XXX 标志,以指示元数据内存要求。
填充KSCAMERA_EXTENDEDPROP_METADATAINFO。具有所需内存对齐方式的 BufferAlignment (KSCAMERA_EXTENDEDPROP_MetadataAlignment_ Xxx) 。 有关可能的值,请参阅 KSCAMERA_EXTENDEDPROP_MetadataAlignment 。
填充 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 |