KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE

This property sets or retrieves the photo mode setting for the camera.

Usage Summary Table

GetSetTargetProperty descriptor typeProperty value type

Yes

Yes

Pin

KSPROPERTY

KSCAMERA_EXTENDEDPROP_HEADER

 

The property value (operation data) contains a KSCAMERA_EXTENDEDPROP_HEADER structure and a KSCAMERA_EXTENDEDPROP_PHOTOMODE structure. These specify the photo mode and the history frame counts when sequence mode is set.

The desired photo mode is set in the Flags member of KSCAMERA_EXTENDEDPROP_HEADER. The photo mode is set to one of the following.

Photo modeDescription
KSCAMERA_EXTENDEDPROP_PHOTOMODE_NORMALNormal still photo operation
KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCEPhoto sequence capture operation

 

The total property data size is sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_PHOTOMODE). The Size member of KSCAMERA_EXTENDEDPROP_HEADER is set to this total property data size.

Note  Setting the photo mode is an asynchronous control operation and KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL must be set in the Capability member of KSCAMERA_EXTENDEDPROP_HEADER.

Remarks

When responding to a KSPROPERTY_TYPE_GET request, the driver sets the members of the KSCAMERA_EXTENDEDPROP_HEADER to the following.

MemberValue
Version1
PinIdThe pin ID for the photo pin.
Size

sizeof(KSCAMERA_EXTENDEDPROP_HEADER) +

sizeof(KSCAMERA_EXTENDEDPROP_PHOTOMODE)

Result

An error value resulting from the attempt to acquire the photo mode data.

Otherwise, 0.

CapabilityKSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL
FlagsCurrent photo mode.

 

Requirements

Version

Available starting with Windows 8.1.

Header

Ksmedia.h (include Ksmedia.h)

See also

KSCAMERA_EXTENDEDPROP_HEADER
KSCAMERA_EXTENDEDPROP_PHOTOMODE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft