2.2.3.17.1 PROPERTY_DESCRIPTION

The PROPERTY_DESCRIPTION structure specifies a device property.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

PropertySet

PropertyId

Capabilities

MinValue

...

MaxValue

...

Step

...

DefaultValue

...

PropertySet (1 byte): An 8-bit unsigned integer that specifies the property set.

Value

Meaning

CameraControl
0x01

This property set category controls camera device settings.

VideoProcAmp
0x02

This property set controls devices that can adjust the image color attributes of analog or digital signals.

PropertyId (1 byte): An 8-bit unsigned integer that contains the identifier of the property within the property set specified by the PropertySet field.

CameraControl properties:

Value

Meaning

Exposure
0x01

This property controls the exposure time of the device.

Focus
0x02

This property controls the focus setting of the device.

Pan
0x03

This property controls the pan setting of the device.

Roll
0x04

This property controls the roll setting of the device.

Tilt
0x05

This property controls the tilt setting of the device.

Zoom
0x06

This property controls the zoom setting of the device.

VideoProcAmp properties:

Value

Meaning

BacklightCompensation
0x01

This property controls the backlight compensation setting of the device. This value MUST be either 0 or 1. The value 0 indicates that backlight compensation is disabled. The value 1 indicates that backlight compensation is enabled.

Brightness
0x02

This property controls the brightness setting of the device.

Contrast
0x03

This property controls the contrast setting of the device.

Hue
0x04

This property controls the hue setting of the device.

WhiteBalance
0x05

This property controls the white balance setting of the device.

Capabilities (1 byte): An 8-bit unsigned integer that specifies how a property is controlled. This field MUST contain a combination of one or more of the following flags.

Flag

Meaning

Manual

0x01

Indicates that the property can be controlled manually.

Auto

0x02

Indicates that the property can be controlled automatically.

MinValue (4 bytes): A 32-bit signed integer containing the minimum allowed value of this property.

MaxValue (4 bytes): A 32-bit signed integer containing the maximum allowed value of this property.

Step (4 bytes): A 32-bit signed integer containing the minimum allowed value by which this property can be incremented or decremented.

DefaultValue (4 bytes): A 32-bit signed integer containing the step value that SHOULD be used to create values within the range defined by the MinValue and MaxValue fields.