KSPROPERTY_CAMERACONTROL_EXTENDED_ISO

This property selects the ISO setting for the camera. The ISO setting is chosen from a group of presets or set to automatic.

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_VALUE structure. The KSCAMERA_EXTENDEDPROP_VALUE is required but not used.

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

The Capability member of KSCAMERA_EXTENDEDPROP_HEADER contains a bitwise OR combination of one or more of the following ISO settings.

ISODescription
KSCAMERA_EXTENDEDPROP_ISO_AUTOThe ISO setting is automatic.
KSCAMERA_EXTENDEDPROP_ISO_50ISO 50
KSCAMERA_EXTENDEDPROP_ISO_80ISO 80
KSCAMERA_EXTENDEDPROP_ISO_100ISO 100
KSCAMERA_EXTENDEDPROP_ISO_200ISO 200
KSCAMERA_EXTENDEDPROP_ISO_400ISO 400
KSCAMERA_EXTENDEDPROP_ISO_800ISO 800
KSCAMERA_EXTENDEDPROP_ISO_1600ISO 1600
KSCAMERA_EXTENDEDPROP_ISO_3200ISO 3200
KSCAMERA_EXTENDEDPROP_ISO_6400ISO 6400
KSCAMERA_EXTENDEDPROP_ISO_12800ISO 12800
KSCAMERA_EXTENDEDPROP_ISO_25600ISO 25600

 

The Flags member of KSCAMERA_EXTENDEDPROP_HEADER contains the current ISO setting for the camera. The camera driver may support a subset of the ISO settings. If this property control is supported, the driver must support KSCAMERA_EXTENDEDPROP_ISO_AUTO.

This property control is asynchronous.

Remarks

Getting the property

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

MemberValue
Version1
PinId The pin ID for the photo pin.
Size

sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)

Result0
CapabilityKSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | (ISO settings supported).
FlagsThe current ISO value setting (only one value).

 

If no ISO was previously set, then Flags is set to KSCAMERA_EXTENDEDPROP_ISO_AUTO (default).

Setting the property

When the property is set, a KSPROPERTY_TYPE_SET request, the Flags member of KSCAMERA_EXTENDEDPROP_HEADER will contain the ISO setting to enable.

Requirements

Version

Available starting with Windows 8.1.

Header

Ksmedia.h (include Ksmedia.h)

See also

KSCAMERA_EXTENDEDPROP_HEADER
KSCAMERA_EXTENDEDPROP_VALUE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft