KSPROPERTY_CAMERACONTROL_S_EX 結構 (ksmedia.h)

發行項
02/29/2024

指定相機控制作業，包括設定快閃、影像釘選控件屬性、影像中感興趣的區域，或影片防震。這個結構描述屬性集中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

指出，針對 [取得要求]，指定屬性值的目前設定如下所列的值。指出，針對 [設定要求] ，指定屬性值的所需設定如下所列的值。此成員可以是 Ksmedia.h 中定義的下列值的位 OR：

值	Description
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 事件。