KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT (アプリケーション パフォーマンス戦略)
カメラ ドライバーは、アプリケーションによって提供されるヒントに基づいてキャプチャ操作を最適化できます。 このプロパティは、最も使用される可能性が高い操作に基づいてパフォーマンス戦略を設定するようにドライバーに通知します。 たとえば、写真用に最適化した場合、カメラ ドライバーはセンサーをプログラムしてセンサーの露出速度と解像度を最適化し、写真キャプチャ トリガーから画像キャプチャまでの待機時間を短縮できます。 同様に、ビデオ用に最適化されている場合、カメラ ドライバーは、より高いフレーム レートで低解像度によりセンサーをプログラムできます。
用法の要点
| Yammer の入手 | 設定 | 移行先 | プロパティ記述子の種類 | プロパティ値の種類 |
|---|---|---|---|---|
| はい | Yes | Assert | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
プロパティ値 (操作データ) には、KSCAMERA_EXTENDEDPROP_HEADER 構造体と KSCAMERA_EXTENDEDPROP_VALUE 構造体が含まれています。
プロパティ データの合計サイズは、sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) です。 KSCAMERA_EXTENDEDPROP_HEADER の Size メンバーは、このプロパティ データの合計サイズに設定されます。
KSCAMERA_EXTENDEDPROP_HEADER の Capability メンバーには、次の補正設定の 1 つ以上のビット論理和の組み合わせが含まれています。
| 最適化ヒント | 説明 |
|---|---|
| KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO | カメラ操作は写真用に最適化されています |
| KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO | カメラ操作はビデオ用に最適化されています |
KSCAMERA_EXTENDEDPROP_HEADER の Flags メンバーには、カメラに現在設定されている最適化が含まれています (1 つの値)。
既定の最適化の種類は KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO です。 このプロパティがカメラ ドライバーでサポートされている場合は、両方の最適化の種類をサポートする必要があります。
このプロパティ コントロールは同期的であり、取り消し可能ではありません。
解説
最適化モード
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO モードを使用するように明示的に通知されるまで、すべてのカメラ ドライバーがこのモードである必要があります。 このモードの目的は、カメラ ハードウェアを写真操作用に最適化することです。 ビデオ操作は、このモードで引き続き機能している必要があります。
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO
このモードは、カメラがビデオ操作に使用される可能性があることを示します。 カメラ ドライバーは、このモードのビデオ操作用にハードウェアを最適化する必要があります。 写真の操作は機能する必要がありますが、リソースの使用の優先順位はビデオ操作用です。
プロパティの取得
KSPROPERTY_TYPE_GET 要求に応答する際、ドライバーは KSCAMERA_EXTENDEDPROP_HEADER のメンバーを次のように設定します。
| メンバー | 値 |
|---|---|
| バージョン | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| サイズ | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| 結果 | 0 |
| 機能 | サポートされている最適化値 |
| Flags | 現在の最適化値の設定 |
最適化モードがまだ設定されていない場合、ドライバーは Flags を KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO (既定) に設定します。
プロパティの設定
プロパティが設定されている場合、KSPROPERTY_TYPE_SET 要求、KSCAMERA_EXTENDEDPROP_HEADER の Flags メンバーには、設定する最適化モードが含まれます。
要件
バージョン: Windows 8.1 以降で使用可能
Header: Ksmedia.h (Ksmedia.h を含む)