擴充相機控制項屬性

擴充相機控制項介面可從 Windows 8 開始，用來控制影像擷取期間的相機功能。 驅動程式可以控制這些相機功能：

• 相機的閃爍
• 影像釘選和記錄釘選是否互斥
• 影像中感興趣的區域
• 防震視訊

驅動程式也可以選擇以非同步方式執行相機控制作業，這表示作業的所有要求都會遭到拒絕，直到第一個要求完成為止。 如果驅動程式已成功執行非同步相機控制作業，它應該會觸發 KSEVENTSETID_CameraAsyncControl 事件。 如需詳細資訊 ，請參閱KSPROPERTY_CAMERACONTROL_S_EX 。

UWP app 可以存取這些屬性來設定相機：

屬性

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY
用來開啟或關閉相機的閃爍，或將閃爍放入自動模式。

KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_PROPERTY
用來識別相機的影像釘選和記錄釘選是否互斥。

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY
用來取得或設定相機感興趣的區域特性。

KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE_PROPERTY
用來取得或設定相機的視訊防震特性。

下列屬性可從 Windows 8.1 開始提供。

詞彙	描述
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE	用來取得或設定相機的一般仍然或相片序列模式。
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOFRAMERATE	當相機的相片模式為序列模式時，用來取得目前的相片擷取畫面播放速率。
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE	用於取得或設定相機處於相片序列模式時的最大擷取畫面播放速率。
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTRIGGERTIME	用來取得或設定相機驅動程式的觸發時間。
KSPROPERTY_CAMERACONTROL_EXTENDED_WARMSTART	用來取得或設定相機就緒) 狀態 (暖開始。
KSPROPERTY_CAMERACONTROL_EXTENDED_MAXVIDFPS_PHOTORES	用來取得或設定在特定解析度的視訊擷取釘選上可能的最大可能畫面播放速率。
KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTHUMBNAIL	用來取得或設定相機的縮圖功能。
KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE	用來取得或設定代表預設控制項集合的驅動程式定義模式。
KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE	用來取得或設定相機的閃爍用於低光情況的方法。
KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE	用來取得或設定相機一般和序列相片模式的閃爍模式作業。
KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT	用來取得或設定自動處理是否為白色平衡或手動溫度值。
KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE	用來取得或設定相機是否針對相片或視訊作業進行優化。
KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE	用來取得或設定是否要針對曝光或手動時間值進行自動處理。
KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE	用來取得或設定相機的自動、手動和預設焦點模式。
KSPROPERTY_CAMERACONTROL_EXTENDED_ISO	用來取得或設定相機的預設或自動 ISO 設定。
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW	用來取得相機位置的視野和傾斜角度。
KSPROPERTY_CAMERACONTROL_EXTENDED_EVCOMPENSATION	用來取得或設定曝光控制調整設定。
KSPROPERTY_CAMERACONTROL_EXTENDED_CAMERAANGLEOFFSET	用來取得相機位置的傾斜和左右角。

這些結構和列舉支援擴充相機控制介面：

結構

• KSPROPERTY_CAMERACONTROL_S_EX
• KSPROPERTY_CAMERACONTROL_FLASH_S
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_S
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S
• KSPROPERTY_CAMERACONTROL_VIDEOSTABILIZATION_MODE_S
• KSCAMERA_EXTENDEDPROP_HEADER
• KSCAMERA_EXTENDEDPROP_VALUE
• KSCAMERA_EXTENDEDPROP_PHOTOMODE
• KSCAMERA_MAXVIDEOFPS_FORPHOTORES
• KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING
• KSCAMERA_EXTENDEDPROP_FIELDOFVIEW

列舉

• KS_CameraControlAsyncOperation
• KSEVENT_CAMERACONTROL
• KSPROPERTY_CAMERACONTROL_FLASH
• KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY
• KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST
• KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE

如何 實作擴充相機控制項屬性中會提供實作此介面的範例驅動程式程式碼。