KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR
KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR 可用來在驅動程式上啟用或停用高動態範圍 (HDR) 視訊。 這是僅限視訊釘選的釘選層級控制項。
使用量摘要表格
| Get | 集合 | 目標 | 屬性描述元類型 |
|---|---|---|---|
| 是 | 是 | Pin | KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR |
下列旗標可以放在KSCAMERA_EXTENDEDPROP_HEADER中。用來控制視訊 HDR 的旗標欄位。 根據預設，驅動程式應設定為 VIDEOHDR_OFF。
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON 0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO 0x0000000000000002
如果驅動程式支援此控制項，它必須支援VIDEOHDR_ON/VIDEOHDR_OFF。
如果驅動程式不支援視訊 HDR，驅動程式不應該實作此控制項。
此控制項可作為驅動程式的提示。 當設定為 VIDEOHDR_ON 時，驅動程式應該以最佳方式執行視訊 HDR。
當視訊釘選處於KSSTATE_RUN狀態時，此控制項的 SET 呼叫沒有任何作用。 如果視訊釘選處於執行中狀態並傳回STATUS_INVALID_DEVICE_STATE，驅動程式應該拒絕收到的 SET 呼叫。 在 GET 呼叫中，驅動程式應該會傳回 [旗標] 欄位中目前的設定。
下表描述旗標功能。
| 旗標 | 描述 |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF | 這是必要功能。 指定時，驅動程式會停用視訊 HDR，而且驅動程式不得在視訊串流上執行視訊 HDR。 |
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON | 這是必要功能。 指定時，驅動程式會啟用視訊 HDR，而驅動程式應以最佳方式執行視訊 HDR。 此旗標與VIDEOHDR_AUTO和VIDEOHDR_OFF旗標互斥。 |
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO | 這項功能是選擇性的。 指定時，支援這類功能的驅動程式會根據場景分析判斷是否應該執行視訊 HDR。 此旗標與VIDEOHDR_ON和VIDEOHDR_OFF旗標互斥。 |
下表包含使用 控制項時 ，KSCAMERA_EXTENDEDPROP_HEADER 結構欄位的描述和需求。
| member | 描述 |
|---|---|
| 版本 | 這必須是 1。 |
| PinId | 必須是與視訊釘選相關聯的 Pin 識別碼。 |
| 大小 | 這必須是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。 |
| 結果 | 指出最後一個 SET 作業的錯誤結果。 如果未執行 SET 作業，這必須是 0。 |
| 功能 | 必須是上面定義的支援KSCAMERA_EXTENDEDPROP_VIDEOHDR_* 旗標的位 OR。 |
| Flags | 這是讀取/寫入欄位。 這可以是上述任何一個KSCAMERA_EXTENDEDPROP_VIDEOHDR_* 旗標。 |
規格需求
最低支援的用戶端：Windows 11
標頭： ksmedia.h (包含 Ksmedia.h)