Edit

KSPROPERTY_CAMERACONTROL_EXTENDED_ADVANCEDPHOTO

  • Article

KSPROPERTY_CAMERACONTROL_EXTENDED_ADVANCEDPHOTO is used to control photo HDR, flash no flash, and ultra low light fusion on the driver. This is a pin level control for photo pin only.

Usage summary table

Scope Control Type

Version 1

Pin

Synchronous

The following are flags that can be placed in the KSCAMERA_EXTENDEDPROP_HEADER.Flags field to control photo HDR, flash no flash, and ultra low light fusion. The default should be KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF.

#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_AUTO            0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_HDR             0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_FNF             0x0000000000000004
#define KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_ULTRALOWLIGHT   0x0000000000000008

If the driver supports this control, it must support KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF.

If the driver does not support any of the advanced photo captures, the driver should not implement this control.

The SET call of this control has no effect when the photo pin is KSSTATE_RUN state. The driver shall reject the SET call received if photo pin is in running state and returns STATUS_INVALID_DEVICE_STATE. In a GET call, driver should return the current settings in Flags field.

The following table describes the flag capabilities.

Flag Description

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_OFF

This is a mandatory capability. When specified, no advanced photo should be performed in the driver.

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_AUTO

This capability is optional. When specified alone, the driver that supports such capability will determine whether photo HDR, Flash no Flash, or ultra low light fusion should be performed based on the scene analysis. This flag is mutually exclusive with the OFF flag and can be used with the other flags.

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_HDR

This capability is optional. When specified alone, the driver that supports such capability will perform photo HDR. This flag is mutually exclusive with the other flags except AUTO. When specified together with AUTO, the driver will determine whether photo HDR should be performed based on the scene analysis.

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_FNF

This capability is optional. When specified alone, the driver that supports such capability will perform flash no flash. This flag is mutually exclusive with the other flags except AUTO. When specified together with AUTO, the driver will determine whether flash no flash should be performed based on the scene analysis.

KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_ULTRALOWLIGHT

This capability is optional. When specified alone, the driver that supports such capability will perform ultra low light fusion. This flag is mutually exclusive with the other flags except AUTO. When specified together with AUTO, the driver will determine whether ultra low light fusion should be performed based on the scene analysis.

The table below contains the descriptions and requirements for the KSCAMERA_EXTENDEDPROP_HEADER structure fields when using the control.

Member Description

Version

This must be 1.

PinId

Must be the Pin ID associated with the photo pin.

Size

This must be sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE).

Result

Indicates the error results of the last SET operation. If no SET operation has taken place, this must be 0.

Capability

Must be a bitwise OR of the supported KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_* flags defined above.

Flags

This is a read/write field. This can be any one of the KSCAMERA_EXTENDEDPROP_ADVANCEDPHOTO_* flags defined above.

Requirements

Header

 Ksmedia.h