| title | KSPROPERTY_CAMERACONTROL_EXTENDED_WARMSTART | |
|---|---|---|
| description | The warm start property control provides a hint for the driver to keep the camera pin ready to allow glitch-free operation. | |
| keywords |
|
|
| topic_type |
|
|
| ms.topic | reference | |
| api_name |
|
|
| api_type |
|
|
| ms.date | 09/11/2018 |
The warm start property control provides a hint for the driver to keep the camera pin ready to allow glitch-free operation.
| Get | Set | Target | Property descriptor type | Property value type |
|---|---|---|---|---|
Yes |
Yes |
Pin |
The property value (operation data) contains a KSCAMERA_EXTENDEDPROP_HEADER structure.
There are no flags set in the Flags member of KSCAMERA_EXTENDEDPROP_HEADER for this property.
The total property data size is sizeof(KSCAMERA_EXTENDEDPROP_HEADER). The Size member of KSCAMERA_EXTENDEDPROP_HEADER is set to this total property data size.
Warm start is enabled or disabled using the one of the following flags in the Capability member of KSCAMERA_EXTENDEDPROP_HEADER.
| Warm start flags | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_WARMSTART_MODE_DISABLED | Warm start is disabled. |
| KSCAMERA_EXTENDEDPROP_WARMSTART_MODE_ENABLED | Warm start is enabled. |
This property control is asynchronous and not cancelable.
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 pin to be utilized for Warm Start |
| Size | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) |
| Result | 0 |
| Capability | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | KSCAMERA_EXTENDEDPROP_WARMSTART_MODE_DISABLED -or- KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | KSCAMERA_EXTENDEDPROP_WARMSTART_MODE_ENABLED |
| Flags | 0 |
The Result member of KSCAMERA_EXTENDEDPROP_HEADER is always set to 0 for a get operation.