KSPROPERTY_CAMERACONTROL_S_EX結構（ksmedia.h）

發行項
02/07/2025

指定相機控件作業，包括設定快閃、圖像釘選控件屬性、影像感興趣的區域，或防視視訊。此結構描述 PROPSETID_VIDCAP_CAMERACONTROL 屬性集中的篩選型屬性。

從 Windows 8 開始支援。

語法

typedef struct {
  KSPROPERTY Property;
  LONG       Value;
  ULONG      Flags;
  ULONG      Capabilities;
  RECT       FocusRect;
} KSPROPERTY_CAMERACONTROL_S_EX, *PKSPROPERTY_CAMERACONTROL_S_EX;

成員

Property

指定描述屬性集、屬性識別碼和要求類型的初始化 KSPROPERTY 結構。

Value

指定屬性的值。這個成員是可擦寫的。

Flags

表示針對 Get 要求，從下面所列的值中，指定之屬性的目前設定。表示在 [設定要求] 中，所指定屬性值所需的設定如下所列的值。此成員可以是 Ksmedia.h中定義的下列值的位 OR：

價值	描述
KSPROPERTY_CAMERACONTROL_FLAGS_AUTO	表示會自動控制設定。如果驅動程式收到此值，它應該將相機控制項同步設定為自動模式，然後傳回。
KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL	表示設定是以手動方式控制。如果驅動程式收到此值，它應該以同步方式將相機控件設定為手動模式，然後傳回。
KSPROPERTY_CAMERACONTROL_FLAGS_ASYNCHRONOUS	指出驅動程式是否應該以異步方式執行相機控制作業，其中應用程式已發出命令，讓驅動程式在拍照之前設定相機控制項設定。只有當已設定 KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL 或 KSPROPERTY_CAMERACONTROL_FLAGS_AUTO 時，才必須設定此旗標。如果同時設定這個旗標值和 KSPROPERTY_CAMERACONTROL_FLAGS_AUTO 旗標值，驅動程式應該起始背景工作線程來啟動一個要求的控件作業，並且應該拒絕相同作業的所有其他要求，直到它完成第一個作業為止。作業成功完成之後，驅動程式應該觸發 KSEVENTSETID_CameraAsyncControl 事件。