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