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 呼び出しでは、ドライバーは次の処理を行います。
KSCAMERA_EXTENDEDPROP_HEADER.Capability に 0 を入力します。
KSCAMERA_EXTENDEDPROP_HEADER.Flags に上記の KSCAMERA_EXTENDEDPROP_METADATA_XXX フラグのいずれかの組み合わせを入力して、メタデータ メモリ要件を示します。
KSCAMERA_EXTENDEDPROP_METADATAINFO.BufferAlignment に必要なメモリ アライメント (KSCAMERA_EXTENDEDPROP_MetadataAlignment_Xxx) を入力します。 使用可能な値については、「KSCAMERA_EXTENDEDPROP_MetadataAlignment」を参照してください。
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 |