KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE
この拡張プロパティ コントロールは、IR カメラの赤外線トーチのパワー レベルとデューティ サイクルを制御するためにクライアントによって使用されます。 これは、標準の KSCAMERA_EXTENDEDPROP_HEADER 構造体と共にドライバーに送信され、その後に KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 構造体が続きます。
用法の要点テーブル
| Yammer の入手 | 設定 | 移行先 | プロパティ記述子の種類 | プロパティ値の種類 |
|---|---|---|---|---|
| はい | Yes | Assert | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
解説
プロパティ要求には、KSCAMERA_EXTENDEDPROP_HEADER 構造体と KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 構造体が含まれています。
プロパティ データの合計サイズは、sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) です。 KSCAMERA_EXTENDEDPROP_HEADER の Size メンバーは、このプロパティ データの合計サイズに設定されます。
以下は、KSCAMERA_EXTENDEDPROP_HEADER.Flags フィールドと KSCAMERA_EXTENDEDPROP_HEADER.Capability フィールドに配置できるフラグです。 IR トーチの動作モードを定義します。
| Torch モード | 説明 |
|---|---|
| KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF | "オフ" |
| KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON | Always On |
| KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATING_FRAME_ILLUMINATION | 他のすべてのフレームに対してオン |
KSCAMERA_EXTENDEDPROP_IRTORCHMODE は常に同期コントロールです。 カメラがストリーミングされていない場合、コントロールには動作が定義されていません。
GET 要求の場合、ドライバーは次のフィールドを設定します。
- カメラがサポートする動作モードを表す上記の KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX フラグのビットマスクを備えた KSCAMERA_EXTENDEDPROP_HEADER.Capability。
- KSCAMERA_EXTENDEDPROP_HEADER.Flags を上記の KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX フラグのいずれかに設定して、現在の動作モードを示します。
- KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING.Mode を 0 に設定します。
- KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING.Min を使用可能な最小電力レベルに設定します。
- KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING.Min を使用可能な最大電力レベルに設定します。
- KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING.Step を電力レベル間の最小増分に設定します。
- KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING.VideoProc.ul を現在の電源レベルに設定します。 この値は、顔認証コントロールで通常使用されるのと同じ電力レベルに既定で設定する必要があります。
SET 要求の場合、ドライバーは次のフィールドを使用します。
- KSCAMERA_EXTENDEDPROP_HEADER.Flags を動作モードに設定します。
- KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING.VideoProc.ul を電源レベルに設定します。 この値は KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF には影響しません。
次の表には、メタデータ コントロールを使用する場合の KSCAMERA_EXTENDEDPROP_HEADER 構造体フィールドの説明と要件が含まれています。
| メンバー | 説明 |
|---|---|
Version |
これは 1 である必要があります。 |
PinId |
KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)。 |
サイズ |
これは sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof([KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING](/windows-hardware/drivers/ddi/ksmedia/ns-ksmedia-tagkscamera_extendedprop_videoprocsetting)) である必要があり、 |
結果 |
同期コントロールの場合、この値は無視されます。 |
機能 |
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF、KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON、または KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION の任意の組み合わせが可能です。 このフィールドは、少なくとも 1 つの機能を報告する必要があります。 フィールドは、KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON または KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION またはその両方を報告する必要があります。 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF 値は省略可能です。 |
Flags |
機能で報告されるフラグのいずれかである必要があります。 規定値は、KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON または KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION のいずれかである必要があります。 |
次の表には、IR トーチ モード制御を使用する場合の KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 構造体フィールドの説明と要件が含まれています。
| メンバー | 説明 |
|---|---|
モード |
未使用。 0 を指定する必要があります。 |
Min/Max/Step |
最小/最大/ステップには、IR 電源設定の最小値/最大値/増分が含まれています。 ドライバーは、GET 操作のためにこれらを返す必要があります。 (最大 – 最小) は、ステップで均等に割り切れる必要があります。 ステップはゼロ (0) にすることはできません。 |
VideoProc |
SET 操作の場合、VideoProc.Value.ul は、Min/Max/Step パラメーターで記述された範囲内の電力レベルを指定する必要があります。 GET 操作の場合、ドライバーは現在の電力レベルを返す必要があります。 |
予約されています。 |
未使用。 ドライバーでは無視する必要があります。 |
要件
ヘッダー |
Ksmedia.h |