共用方式為

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 結構欄位的描述和需求。

member 描述

版本

這必須是 1。

PinId

這必須是與圖釘相關聯的 Pin 識別碼，其框架包含元數據。 這可以是任何預覽、記錄和影像釘選。

大小

這必須是sizeof (KSCAMERA_EXTENDEDPROP_HEADER) +sizeof (KSCAMERA_EXTENDEDPROP_METADATAINFO) ，

結果

這表示上次 SET 作業的錯誤結果。 如果沒有進行 SET 作業，這必須是 0。

功能

這是未使用的，而且必須是 0。

Flags

這是讀取/寫入欄位。 這可以是 KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED 或KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY的任何組合。

規格需求

標頭

 Ksmedia.h