共用方式為


KSPROPERTY_CAMERACONTROL_EXTENDED_ADVANCEDPHOTO

KSPROPERTY_CAMERACONTROL_EXTENDED_ADVANCEDPHOTO可用來控制相片 HDR、不閃爍的閃爍,以及驅動程式上的超低光線融合。 這是僅限相片釘選的釘選層級控件。

使用量摘要表格

範圍 控制 類型

第 1 版

Pin

同步

以下是可以放在KSCAMERA_EXTENDEDPROP_HEADER中的旗標。旗標欄位,可控制相片 HDR、不閃爍閃爍,以及超低光線融合。 預設值應該是KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF。

#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_AUTO            0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_HDR             0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_FNF             0x0000000000000004
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_ULTRALOWLIGHT   0x0000000000000008

如果驅動程式支援此控件,它必須支援KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF。

如果驅動程式不支援任何進階相片擷取,驅動程式就不應該實作此控件。

當相片釘選處於KSSTATE_RUN狀態時,此控件的SET呼叫沒有任何作用。 如果相片釘選處於執行中狀態並傳回STATUS_INVALID_DEVICE_STATE,驅動程式應拒絕收到的SET呼叫。 在 GET 呼叫中,驅動程式應該會傳回 [旗標] 字段中目前的設定。

下表描述旗標功能。

旗標 描述

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF

這是必要功能。 指定時,應該不會在驅動程式中執行進階相片。

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_AUTO

這項功能是選擇性的。 單獨指定時,支援這類功能的驅動程式會根據場景分析判斷是否應該根據場景分析來執行相片 HDR、不閃爍或超低光線融合。 此旗標與 OFF 旗標互斥,可以與其他旗標搭配使用。

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_HDR

這項功能是選擇性的。 單獨指定時,支援這類功能的驅動程式會執行相片 HDR。 除了 AUTO 以外,此旗標與其他旗標互斥。 與 AUTO 一起指定時,驅動程式會根據場景分析判斷是否應該執行相片 HDR。

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_FNF

這項功能是選擇性的。 單獨指定時,支援這類功能的驅動程式會執行不快閃。 除了 AUTO 以外,此旗標與其他旗標互斥。 與 AUTO 一起指定時,驅動程式會判斷是否應該根據場景分析執行不快閃。

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_ULTRALOWLIGHT

這項功能是選擇性的。 單獨指定時,支援這類功能的驅動程式會執行超低光線融合。 除了 AUTO 以外,此旗標與其他旗標互斥。 與 AUTO 一起指定時,驅動程式會根據場景分析來判斷是否應該執行超低光線融合。

下表包含使用 控件時 ,KSCAMERA_EXTENDEDPROP_HEADER 結構欄位的描述和需求。

member 描述

版本

這必須是 1。

PinId

必須是與相片釘選相關聯的 Pin 識別碼。

大小

這必須是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。

結果

指出最後一個SET作業的錯誤結果。 如果未執行 SET 作業,這必須是 0。

功能

必須是上述所支援KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_* 旗標的位 OR。

Flags

這是讀取/寫入欄位。 這可以是上述任何一個KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_* 旗標。

規格需求

標頭

Ksmedia.h