Edit

KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE (submode)

  • Article

The KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE property allows a submode to be configured.

Usage summary

The following submodes are defined as follows.

#define KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_NONE       0x00000000
#define KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE   0x00000001

KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_NONE is used by a regular photo sequence.

KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE is used to indicate a photo sequence is variable. If per-frame settings are specified, the KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE flag will be specified in the submode field of the KSCAMERA_EXTENDEDPROP_PHOTOMODE structure to indicate a variable photo sequence, even if no item settings are specified (item count is 0 for all frames). When the frame count is 1 and the item count is 0, the variable photo sequence reduces to one frame variable photo sequence using global settings.

The following is a definition of the KSCAMERA_EXTENDEDPROP_PHOTOMODE structure defined in ksmedia.h:

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

Variable photo sequence mode has the following unique characteristics on a photo sequence.

  • Always use a finite photo sequence.

  • Per frame settings are applied when the frame count is greater than 0.

  • The driver will automatically stop the photo sequence at the end without the need for the KS_VideoControlFlag_StopPhotoSequenceCapture trigger when a loop count of greater than 0 is specified.

  • The last sample must be marked with the KSSTREAM_HEADER_OPTIONSF_ENDOFPHOTOSEQUENCE flag.

  • The capture pipeline will not drop any sample from the driver.

  • Neither the pipeline nor the driver\MFT0 generates any photo thumbnail.

This property is asynchronous and not cancelable.

Requirements

Header: Ksmedia.h (include Ksmedia.h)