KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSPRIORITY

KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY列舉中定義的KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSPRIORITY屬性標識碼可用來設定焦點優先順序。 設定焦點優先順序時，焦點將優先於拍攝的圖片，以確保拍攝的圖片一律處於焦點中。 否則，無論圖片是否在焦點中，都會立即拍攝圖片。 處理失敗焦點的行為，以及是否需要逾時是驅動程序內部的，以及是否為 OEM。

使用量摘要表格

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

若要設定焦點優先順序，必須使用 KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSPRIORITY 屬性標識符。 設定焦點優先順序時，焦點將優先於拍攝的圖片，以確保拍攝的圖片一律處於焦點中。 如果未設定焦點優先順序，則不論圖片是否處於焦點，都會立即拍攝圖片。 處理失敗焦點的行為失敗，且逾時是由 OEM 決定，而且是驅動程式內部的行為。

針對 KSCAMERA_EXTENDEDPROP_HEADER，下列旗標會定義為值。 在取得呼叫中，相機驅動程式會使用下列其中一個旗標傳回其目前的焦點優先順序設定。 在設定呼叫中，數位相機驅動程式會使用下列其中一個旗標來設定新的焦點優先順序設定。

#define KSCAMERA_EXTENDEDPROP_FOCUSPRIORITY_OFF     0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_FOCUSPRIORITY_ON      0x0000000000000001

注意 這是同步控制件，而且此控件沒有定義任何功能。

下表包含使用焦點優先順序控件時 ，KSCAMERA_EXTENDEDPROP_HEADER 結構欄位的描述和需求。

member	描述
版本	這必須是 1，
PinId	這必須KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) ，
大小	這必須是sizeof (KSCAMERA_EXTENDEDPROP_HEADER) +sizeof (KSCAMERA_EXTENDEDPROP_VALUE) ，
結果	這表示錯誤結果，
功能	這必須是 0，
Flags	這是讀取/寫入欄位。 這可以是上述任何一個KSCAMERA_EXTENDEDPROP_FOCUSPRIORITY_Xxx旗標。

規格需求

標頭

Ksmedia.h