KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS

[アーティクル]
2025-03-27

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS は、カメラドライバーが複数の固定視野 (FoV) 設定を提供できるようにするプロパティ ID です。この設定は、ユーザーが [カメラ設定] ページまたはアプリケーションで選択できます。

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS ペイロード配列で報告されるビューのフィールド値は、降順で並べ替える必要があります (たとえば、最初に最大値)。
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS によって報告されるすべての視野 (FoV) 値は、ドライバーがサポートすることを選択したすべての使用可能なメディアの種類でサポートされている必要があります。
- ドライバーは、特定の解像度で FoV を実現するためにスケーリングやトリミングを行うことができます。
- 例外は、カメラプロファイルをサポートし、KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2を BlockedControl として追加することで行うことができます。その結果、FIELDOFVIEW2 コントロールをブロックするプロファイルが使用されている場合は、コントロールがまったくサポートされません。

使用状況の概要テーブル

範囲	取得	オン	コントロール	タイプ
Version 1	イエス	いいえ	フィルター	同期

KSCAMERA_EXTENDEDPROP_HEADER構造体フィールド

次の表に、コントロールを使用する場合の KSCAMERA_EXTENDEDPROP_HEADER 構造体フィールドの要件を示します。

メンバー	説明
バージョン	1 にする必要があります。
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
サイズ	sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS) である必要があります
結果	0 を含む必要があります。このフィールドは、最後の非同期 SET 操作の結果を返すためにのみ使用されます。
能力	0 にする必要があります。
フラグ	0 にする必要があります。

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS ペイロード

ヘッダー構造に続くペイロードは必須の KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPSです。

パラメーター	説明
DefaultDiagonalFieldOfViewInDegrees	ビューの既定のフィールド (FoV) 値。 DiscreteFoVStops 配列で報告される値のいずれかである必要があります。
DiscreteFoVStopsCount	DiscreteFovStops の有効なエントリの数。最大 360、最小 1。
DiscreteFoVStops	有効なビューフィールド (FoV) ストップの配列。DiscreteFoVStopsCount のみが有効な項目です。
予約済み	0 に設定します。