KSPROPERTY_CAMERACONTROL_EXTENDED_OIS

KSPROPERTY_CAMERACONTROL_EXTENDED_OIS 是屬性標識符，可用來控制驅動程式上的光學影像防震 (OIS) 。

使用量摘要表格

範圍	控制	類型
第 1 版	篩選	同步

下列旗標可以放在 KSCAMERA_EXTENDEDPROP_HEADER中。用來 控制光學影像防震的旗標欄位。 如果支援 AUTO，則預設值應該是 AUTO，否則為 ON。

#define KSCAMERA_EXTENDEDPROP_OIS_OFF   0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_OIS_ON    0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_OIS_AUTO  0x0000000000000002 

如果驅動程式支援此控制件，它必須支援OIS_ON和OIS_OFF。

如果驅動程式不支援光學防震，驅動程式就不應該實作此控件。

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

下表描述旗標功能。

旗標	描述
KSCAMERA_EXTENDEDPROP_OIS_OFF	這是必要功能。 指定時，驅動程式會停用光學影像防震。
KSCAMERA_EXTENDEDPROP_OIS_ON	這是必要功能。 指定時，會在驅動程式中啟用光學影像防震。 此旗標與OIS_AUTO和OIS_OFF旗標互斥。
KSCAMERA_EXTENDEDPROP_OIS_AUTO	這項功能是選擇性的。 指定時，支援這類功能的驅動程式會決定是否應該開啟或關閉光學影像防震。 此旗標與OIS_ON和OIS_OFF旗標互斥。

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

member	描述
版本	這必須是 1。
PinId	這必須KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) 。
大小	這必須是 sizeof (KSCAMERA_EXTENDEDPROP_HEADER) + sizeof (KSCAMERA_EXTENDEDPROP_VALUE) 。
結果	指出最後一個SET作業的錯誤結果。 如果未執行 SET 作業，這必須是 0。
功能	必須是上述所支援KSCAMERA_EXTENDEDPROP_OIS_* 旗標的位 OR。
Flags	這是讀取/寫入欄位。 這可以是上述任何一個KSCAMERA_EXTENDEDPROP_OIS_* 旗標。

規格需求

標頭

Ksmedia.h