KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTHUMBNAIL
このプロパティは、カメラのサムネイル機能を取得または設定します。 スケール ファクターが指定されている場合、サムネイルは選択したスケールで有効になります。
用法の要点テーブル
| Yammer の入手 | 設定 | 移行先 | プロパティ記述子の種類 | プロパティ値の種類 |
|---|---|---|---|---|
はい |
はい |
ピン留めする |
プロパティ値 (操作データ) には、KSCAMERA_EXTENDEDPROP_HEADER 構造体と KSCAMERA_EXTENDEDPROP_VALUE 構造体が含まれています。 KSCAMERA_EXTENDEDPROP_VALUE は必須ですが、Value メンバーは無視されます。
プロパティ データの合計サイズは、sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) です。 KSCAMERA_EXTENDEDPROP_HEADER の Size メンバーは、このプロパティ データの合計サイズに設定されます。
KSCAMERA_EXTENDEDPROP_HEADER の Capability メンバーには、サポートされている次のスケール値の 1 つ以上のビット論理和の組み合わせが含まれています。
| サムネイル スケール フラグ | 説明 |
|---|---|
| KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_DISABLE | サムネイルは無効になっています。 |
| KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_2X | サムネイルの解像度は X/2 と Y/2 です。 |
| KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_2X | サムネイルの解像度は X/4 と Y/4 です。 |
| KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_8X | サムネイルの解像度は X/8 と Y/8 です。 |
| KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_16X | サムネイルの解像度は X/16 と Y/16 です。 |
KSCAMERA_EXTENDEDPROP_HEADER の Flags メンバーには、カメラに現在設定されているサムネイル スケール値が含まれています。 サムネイルの生成が有効になっていない場合は、Flags で KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_DISABLE のみが設定されます。
このプロパティ コントロールは非同期であり、取り消し可能ではありません。
解説
プロパティの取得
KSPROPERTY_TYPE_GET 要求に応答する際、ドライバーは KSCAMERA_EXTENDEDPROP_HEADER のメンバーを次のように設定します。
| メンバー | 値 |
|---|---|
| バージョン | 1 |
| PinId | 写真ピンのピン ID。 |
| サイズ | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| 結果 | サムネイル設定の取得の試行に起因するエラー値。 |
| 機能 | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | (サムネイル スケール値がサポートされています)。 |
| Flags | 現在のサムネイル値の設定 (1 つの値のみ)。 |
プロパティの設定
プロパティが設定されている場合、KSPROPERTY_TYPE_SET 要求、KSCAMERA_EXTENDEDPROP_HEADER の Flags メンバーにサムネイル スケール フラグのいずれかが含まれます。
要件
バージョン |
Windows 8.1 以降で使用できます。 |
ヘッダー |
ksmedia.h (Ksmedia.h をインクルード) |