KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE (子模式)

KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE 属性允许配置子模式。

使用情况摘要

以下子模式定义如下。

#define KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_NONE       0x00000000
#define KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE   0x00000001

KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_NONE由常规照片序列使用。

KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE用于指示照片序列是可变的。 如果指定了每帧设置,则会在KSCAMERA_EXTENDEDPROP_PHOTOMODE结构的子模式字段中指定KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE标志,以指示可变照片序列,即使未指定任何项目设置, (所有帧的项计数为 0) 也是如此。 当帧计数为 1 且项目计数为 0 时,可变照片序列使用全局设置减少为一帧可变照片序列。

下面是 ksmedia.h 中定义的KSCAMERA_EXTENDEDPROP_PHOTOMODE结构的定义:

typedef struct tagKSCAMERA_EXTENDEDPROP_PHOTOMODE {  
    ULONG       RequestedHistoryFrames;  
    ULONG       MaxHistoryFrames;  
    ULONG       SubMode;  
    ULONG       Reserved;  
} KSCAMERA_EXTENDEDPROP_PHOTOMODE, *PKSCAMERA_EXTENDEDPROP_PHOTOMODE;

可变照片序列模式在照片序列上具有以下唯一特征。

  • 始终使用有限照片序列。

  • 当帧计数大于 0 时,将应用每帧设置。

  • 指定循环计数大于 0 时,驱动程序将在末尾自动停止照片序列,而无需KS_VideoControlFlag_StopPhotoSequenceCapture触发器。

  • 最后一个示例必须使用 KSSTREAM_HEADER_OPTIONSF_ENDOFPHOTOSEQUENCE 标志进行标记。

  • 捕获管道不会从驱动程序中删除任何示例。

  • 管道和 driver\MFT0 都不会生成任何照片缩略图。

此属性是异步的,不可取消。

要求

头: Ksmedia.h (包括 Ksmedia.h)