Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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) |