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
| Get | Set | Target | Property descriptor type | Property value type |
|---|---|---|---|---|
Yes |
Yes |
Pin |
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.
| ISO | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_ISO_AUTO | The ISO setting is automatic. |
| KSCAMERA_EXTENDEDPROP_ISO_50 | ISO 50 |
| KSCAMERA_EXTENDEDPROP_ISO_80 | ISO 80 |
| KSCAMERA_EXTENDEDPROP_ISO_100 | ISO 100 |
| KSCAMERA_EXTENDEDPROP_ISO_200 | ISO 200 |
| KSCAMERA_EXTENDEDPROP_ISO_400 | ISO 400 |
| KSCAMERA_EXTENDEDPROP_ISO_800 | ISO 800 |
| KSCAMERA_EXTENDEDPROP_ISO_1600 | ISO 1600 |
| KSCAMERA_EXTENDEDPROP_ISO_3200 | ISO 3200 |
| KSCAMERA_EXTENDEDPROP_ISO_6400 | ISO 6400 |
| KSCAMERA_EXTENDEDPROP_ISO_12800 | ISO 12800 |
| KSCAMERA_EXTENDEDPROP_ISO_25600 | ISO 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 and not cancelable.
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.
| Member | Value |
|---|---|
| Version | 1 |
| PinId | The pin ID for the photo pin. |
| Size | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Result | 0 |
| Capability | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | (ISO settings supported). |
| Flags | The 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) |