KSPROPERTY_CAMERACONTROL_EXTENDED_CAMERAANGLEOFFSET

カメラ アングル オフセット プロパティは、カメラの位置のピッチおよびヨーの角度に関する読み取り専用情報を提供します。 ピッチおよびヨーの角度は、横軸と縦軸からのオフセットとして定義されます。

使用状況概要表

取得	設定	対象	プロパティ記述子の種類	プロパティ値の種類
はい	いいえ	フィルター	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

プロパティ値 (操作データ) には、KSCAMERA_EXTENDEDPROP_HEADER 構造と KSCAMERA_EXTENDEDPROP_CAMERAOFFSET 構造が含まれています。

プロパティ データの合計サイズは、sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_CAMERAOFFSET) です。 KSCAMERA_EXTENDEDPROP_HEADER の Size メンバーは、このプロパティ データの合計サイズに設定されます。

KSCAMERA_EXTENDEDPROP_HEADER の Capability および Flags メンバーは、このプロパティには使用されません。

ドライバーがカメラの正しい視野を判断できない場合、ドライバーでこのプロパティをサポートするように指示することはできません。

このプロパティ コントロールは同期的であり、取り消し可能ではありません。

備考

カメラ センサーとジャイロ センサーの両方が同じ物理シャーシに格納されている場合は、カメラ ドライバーが適切なオフセット角度 (おそらく 0 度) を報告することをお勧めします。 カメラ センサーとジャイロ センサーが同じ物理シャーシに格納されていない場合は、ドライバーでこのプロパティをサポートするように指示しないことをお勧めします。

プロパティの取得

KSPROPERTY_TYPE_GET 要求に応答する際、ドライバーは KSCAMERA_EXTENDEDPROP_HEADER のメンバーを次のように設定します。

メンバー	値
バージョン	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)。
サイズ	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_CAMERAOFFSET)
結果	0
機能	0
Flags	0

ドライバーは、KSCAMERA_EXTENDEDPROP_CAMERAOFFSET 構造でアングル オフセットを設定します。

要件

バージョン	Windows 8.1 以降で使用できます。
ヘッダー	ksmedia.h (Ksmedia.h を含む)

関連項目

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_CAMERAOFFSET