KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW

  • [アーティクル]

KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW は、カメラのストリーミング中のカメラの視野とズームを指定するプロパティ ID です。

このコントロールは、パン、傾斜、ズームの代わりに使用できる可能性があります。 このコントロールは、カメラがアクティブにストリーミングしている間にのみ適用されます。 アクティブにストリーミングするということは、プレビュー ピンまたはレコード ピンが KSSTATE_RUN の状態にあり、フレームを配信できる状態にあることを意味します。

SET では、ストリームがアクティブでない場合、このコントロールは STATUS_INVALID_DEVICE_STATE を返します。

KSPROPERTY コントロールの設定例は、GitHub の AVStream カメラ サンプル ドライバーでご確認ください。

使用状況概要表

範囲 コントロール タイプ
バージョン 1 フィルター 同期

次のビット フラグは、ドライバーのプロパティ ID を制御します。

#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING    0x0000000000000001

機能の説明

次のフラグは、KSCAMERA_EXTENDEDPROP_HEADER.Flags フィールドと KSCAMERA_EXTENDEDPROP_HEADER.Capability フィールドに配置できます。

フラグ 説明
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL Digital Window は、アプリケーションによって手動で制御されます。
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING カメラは、Digital Window を自動的に調整して、ビュー内の最も目立つ顔に焦点を当てます。

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW は、常に同期コントロールです。

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

メンバー 説明
バージョン 1 にする必要があります。
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
サイズ sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+ sizeof(KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING) である必要があります。
結果 0 を含める必要があります。 このフィールドは、最後の非同期 SET 操作の結果を返すためにのみ使用されます。
機能 KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL をサポートする必要があります。 必要に応じて、KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING をサポートできます。
Flags KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL または KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING である必要があります。

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

これらのパラメーターは、Flags フィールドに KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING が設定されている場合、読み取り専用です。 SET 操作中に KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING が設定されている場合、次のパラメーターは無視されます。

パラメーター 説明
OriginX X 軸方向のデジタル ウィンドウの起点 (Q24 形式)。 既定で 0 にする必要があります。 OriginX は PorchLeft より小さく、PorchRight – WindowSize より大きくすることはできません。
OriginY X 軸方向のデジタル ウィンドウの起点 (Q24 形式)。 既定で 0 にする必要があります。 OriginX は PorchLeft より小さく、PorchRight – WindowSize より大きくすることはできません。
WindowSize 両方の軸方向のデジタル ウィンドウのサイズ (Q24 形式)。 これは、x 軸方向と y 軸方向に表示される完全なビューの比率です。 WindowSize は既定で 0x01000000 (Q24 では 1.0) にする必要があります。 WindowSize は MinWindowSize より小さく、MaxWindowSize より大きくすることはできません。 さらに、WindowSize と OriginX は PorchRight より大きくすることはできません。WindowsSize と OriginY は PorchBottom より大きくすることはできません。
予約されています。 を 0 に設定します。

要件

サポートされている最低限のクライアント: Windows 11

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

関連項目

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_CONFIGCAPS

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_CONFIGCAPSHEADER

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

KSCAMERA_METADATA_DIGITALWINDOW