Edit

KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE

  • Article

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

Usage summary table

Get Set Target Property descriptor type Property value type
Yes Yes Filter 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 mode Description
KSCAMERA_EXTENDEDPROP_PHOTOMODE_NORMAL Normal still photo operation
KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE Photo 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.

Member Value
Version 1
PinId The 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.
Capability KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL
Flags Current photo mode

Requirements

Version: Available starting with Windows 8.1

Header: Ksmedia.h (include Ksmedia.h)

See also

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_PHOTOMODE