KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE

The flash property control sets flash mode operation for both normal and sequence photo mode of the camera.

Usage Summary Table

GetSetTargetProperty descriptor typeProperty value type

Yes

Yes

Filter

KSPROPERTY

KSCAMERA_EXTENDEDPROP_HEADER

 

The property value (operation data) contains a KSCAMERA_EXTENDEDPROP_HEADER structure and a KSCAMERA_EXTENDEDPROP_VALUE structure.

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 flash modes that are supported by the driver.

Flash modeDescription
KSCAMERA_EXTENDEDPROP_FLASH_OFFFlash is off.
KSCAMERA_EXTENDEDPROP_FLASH_ONFlash is on at the default intensity level.
KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWERFlash is on at a specific power level.
KSCAMERA_EXTENDEDPROP_FLASH_AUTOFlash is automatic based on lighting conditions.
KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWERFlash is automatic based on lighting conditions at a specific power level.

 

The following feature flags can be combined with the previous flash settings except for KSCAMERA_EXTENDEDPROP_FLASH_OFF.

Flash featureDescription
KSCAMERA_EXTENDEDPROP_FLASH_REDEYEREDUCTIONEnable redeye reduction feature. This flag can be combined with any other setting.
KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASHSet flash for only one trigger. This feature is ignored when the camera is not in photo sequence mode.
KSCAMERA_EXTENDEDPROP_FLASH_MULTIFLASHSUPPORTEDSet flash to trigger on every sequence frame. This feature is ignored when the camera is not in photo sequence mode.

 

The Flags member of KSCAMERA_EXTENDEDPROP_HEADER contains the flash mode currently set for the camera.

The default flash mode for a camera is KSCAMERA_EXTENDEDPROP_FLASH_OFF. If the camera supports flash, KSCAMERA_EXTENDEDPROP_FLASH_OFF, KSCAMERA_EXTENDEDPROP_FLASH_ON, and KSCAMERA_EXTENDEDPROP_FLASH_AUTO are required modes. The KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER and KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER modes are optional.

If photo sequence mode is supported by the camera, the flash control property is required with support for KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH.

This property control is synchronous.

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 KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).
Size

sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)

Result0
CapabilityFlash mode values supported.
Flags(The current flash mode value setting) | (flash feature flags)

 

When the torch mode is KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER or KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER, the Value.ull member of KSCAMERA_EXTENDEDPROP_VALUE contains an intensity level value between 0 - 100. An intensity of 0 indicates a minimum level and an intensity of 100 indicates a maximum intensity level. When the adjustable power flags are not set, the value for the normalized intensity setting is returned in Value.ull.

If no flash mode was previously set, then Flags is set to KSCAMERA_EXTENDEDPROP_FLASH_OFF (default).

Setting the property

When the property is set, a KSPROPERTY_TYPE_SET request, the Flags member of KSCAMERA_EXTENDEDPROP_HEADER will contain the torch mode to set. The Value.ull member of KSCAMERA_EXTENDEDPROP_VALUE will contain the intensity level to set if Flags is KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER or KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER.

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