次の方法で共有

KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA

  • [アーティクル]

この拡張プロパティ コントロールは、メタデータ バッファーの要件をドライバーに照会するためにクライアントによって使用されます。 これは、標準の KSCAMERA_EXTENDEDPROP_HEADER 構造体と共にドライバーに送信され、その後に KSCAMERA_EXTENDEDPROP_METADATAINFO 構造体が続きます。

用法の要点

範囲 コントロール Type

Version 1

ピン留めする

同期

以下は、KSCAMERA_EXTENDEDPROP_HEADER.Flags フィールドに配置できるメタデータ フラグです。

#define KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY                     0x0000000000000001  
#define KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED                0x0000000000000100

Get 呼び出しでは、ドライバーは次の処理を行います。

  1. KSCAMERA_EXTENDEDPROP_HEADER.Capability に 0 を入力します。

  2. KSCAMERA_EXTENDEDPROP_HEADER.Flags に上記の KSCAMERA_EXTENDEDPROP_METADATA_XXX フラグのいずれかの組み合わせを入力して、メタデータ メモリ要件を示します。

  3. KSCAMERA_EXTENDEDPROP_METADATAINFO.BufferAlignment に必要なメモリ アライメント (KSCAMERA_EXTENDEDPROP_MetadataAlignment_Xxx) を入力します。 使用可能な値については、「KSCAMERA_EXTENDEDPROP_MetadataAlignment」を参照してください。

  4. KSCAMERA_EXTENDEDPROP_METADATAINFO.MaxMetadataBufferSize に必要なメタデータ バッファー サイズをバイト単位で入力します。

次の表には、メタデータ コントロールを使用する場合の KSCAMERA_EXTENDEDPROP_HEADER 構造体フィールドの説明と要件が含まれています。

メンバー 説明

Version

これは 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