KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS

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 コントロールをブロックするプロファイルが使用されている場合、FIELDOFVIEW2 コントロールはまったくサポートされなくなります。

使用状況の概要表

範囲 Yammer の入手 設定 コントロール タイプ
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 payload

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

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

要件

サポートされている最小クライアント: Windows 11、バージョン 24H2

ヘッダー: ksmedia.h (Ksmedia.h を含む)

関連項目

KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2