KSPROPERTY_CAMERACONTROL_NODE_FOCAL_LENGTH_S structure (ksmedia.h)

The KSPROPERTY_CAMERACONTROL_NODE_FOCAL_LENGTH_S structure returns node-specific data requested using the KSPROPERTY_CAMERACONTROL_FOCAL_LENGTH property.

Syntax

typedef struct {
  KSNODEPROPERTY NodeProperty;
  LONG           lOcularFocalLength;
  LONG           lObjectiveFocalLengthMin;
  LONG           lObjectiveFocalLengthMax;
} KSPROPERTY_CAMERACONTROL_NODE_FOCAL_LENGTH_S, *PKSPROPERTY_CAMERACONTROL_NODE_FOCAL_LENGTH_S;

Members

NodeProperty

Specifies both the target node and the property to get. This member is an initialized structure of type KSNODEPROPERTY.

lOcularFocalLength

Specifies a value of type LONG containing the focal length of the lens closest to the camera user.

lObjectiveFocalLengthMin

Specifies a value of type LONG containing the minimum focal length of the lens closest to the camera subject.

lObjectiveFocalLengthMax

Specifies a value of type LONG containing the maximum focal length of the lens closest to the camera subject.

Remarks

If the camera has only one lens, these values can be used to represent zoom ratios. See KSPROPERTY_CAMERACONTROL_FOCAL_LENGTH.

Requirements

Requirement	Value
Header	ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY

KSPROPERTY_CAMERACONTROL_FOCAL_LENGTH

KSPROPERTY_CAMERACONTROL_FOCAL_LENGTH_S

PROPSETID_VIDCAP_CAMERACONTROL