KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE
用戶端會使用此擴充屬性控制器來控制 IR 相機的基礎結構電筒電源等級和工作週期。 它會連同標準 KSCAMERA_EXTENDEDPROP_HEADER 結構一起傳送至驅動程式，後面接著 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 結構。
使用量摘要數據表
| Get | Set | 目標 | 屬性描述項類型 | 屬性值類型 |
|---|---|---|---|---|
| Yes | Yes | 篩選 | 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中放置的旗標 。旗標 和 KSCAMERA_EXTENDEDPROP_HEADER。功能 欄位。 他們會定義 IR 手電筒筒筒的作業模式， () 。
| 手電筒筒模式 | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF | 關閉 |
| KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON | Always on |
| KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATING_FRAME_ILLUMINATION | 針對其他每個畫面開啟 |
KSCAMERA_EXTENDEDPROP_IRTORCHMODE一律是同步控件。 當相機未串流時，控件沒有定義的行為。
針對 GET 要求，驅動程式會設定下列欄位：
- KSCAMERA_EXTENDEDPROP_HEADER。 具有上述KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX 旗標位掩碼的功能，代表相機支援的作業模式。
- KSCAMERA_EXTENDEDPROP_HEADER。 上述其中一個旗標的旗標KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX 旗標，表示目前的作業模式。
- KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING。模式 為 0。
- KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING。最小 到可用的最小電源等級。
- KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING。最大 到可用的最大電源等級。
- KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING。逐步 執行電源等級之間的最小增量。
- KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING。VideoProc.ul 至目前的電源等級。 此值應該預設為臉部驗證控件通常使用的相同電源等級。
針對 SET 要求，驅動程式會使用下列欄位：
- KSCAMERA_EXTENDEDPROP_HEADER。 設定作業模式的旗標。
- KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING。VideoProc.ul 可設定電源等級。 這個值不會影響KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF。
下表包含使用元數據控制項時 ，KSCAMERA_EXTENDEDPROP_HEADER 結構欄位的描述和需求。
| member | 描述 |
|---|---|
版本 |
這必須是 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的任何組合。 此欄位必須報告至少一項功能。 欄位必須報告 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 結構欄位的描述和需求。
| member | 描述 |
|---|---|
[模式] |
未使用的。 必須是 0。 |
最小值/最大值/步驟 |
Min/Max/Step 包含 IR 電源設定的最小/最大/增量。 驅動程式必須針對 GET 作業傳回這些專案。 (最大值 – 最小) 必須依逐步平均除。 步驟可能不是 0 (0) 。 |
VideoProc |
對於 SET 作業，VideoProc.Value.ul 必須指定 Min/Max/Step 參數所描述範圍內的電源等級。 針對 GET 作業，驅動程式必須傳回目前的電源等級。 |
保留 |
未使用的。 驅動程式必須忽略。 |
規格需求
標頭 |
Ksmedia.h |