KSPROPERTY_CAMERACONTROL_EXTENDED_WARMSTART

The warm start property control provides a hint for the driver to keep the camera pin ready to allow glitch-free operation.

Usage Summary Table

Get Set Target Property descriptor type Property value type

Yes

Yes

Pin

KSPROPERTY

KSCAMERA_EXTENDEDPROP_HEADER

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.

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)

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.

See also

KSCAMERA_EXTENDEDPROP_HEADER