KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE

The scene mode property selects a driver defined mode which represents a collection of preset controls. The driver determines the presets assigned to a scene mode and enables those control settings when a scene is selected.

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 KSCAMERA_EXTENDEDPROP_VALUE is required but the Value member is ignored.

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

Scene modeDescription
KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTOAutomatic scent mode. Controls are at their auto settings.
KSCAMERA_EXTENDEDPROP_SCENEMODE_MACROMacro scene mode (driver defined).
KSCAMERA_EXTENDEDPROP_SCENEMODE_PORTRAITPortrait scene mode (driver defined).
KSCAMERA_EXTENDEDPROP_SCENEMODE_SPORTSport scene mode (driver defined).
KSCAMERA_EXTENDEDPROP_SCENEMODE_SNOWSnow scene mode (driver defined).
KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHTNight scene mode (driver defined).
KSCAMERA_EXTENDEDPROP_SCENEMODE_BEACHBeach scene mode (driver defined).
KSCAMERA_EXTENDEDPROP_SCENEMODE_SUNSETSunset scene mode (driver defined).
KSCAMERA_EXTENDEDPROP_SCENEMODE_CANDLELIGHTCandlelight scene mode (driver defined).
KSCAMERA_EXTENDEDPROP_SCENEMODE_LANDSCAPELandscape scene mode (driver defined).
KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHTPORTRAITNight portrait scene mode (driver defined).
KSCAMERA_EXTENDEDPROP_SCENEMODE_BACKLITBacklit scene mode (driver defined).
KSCAMERA_EXTENDEDPROP_SCENEMODE_MANUALControls are manually changed and no pre-defined scene modes are set.

 

The Flags member of KSCAMERA_EXTENDEDPROP_HEADER contains the scene mode currently set for the camera. The default scene mode for a camera is always KSCAMERA_EXTENDEDPROP_SCENEMODE_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.

MemberValue
Version1
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).
Size

sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)

Result0
CapabilityKSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | (scene mode values supported).
FlagsThe current scene mode value setting (only one value).

 

If no scene mode was previously set, then Flags is set to KSCAMERA_EXTENDEDPROP_SCENEMODE_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 scene mode to enable.

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

Afficher:
© 2014 Microsoft