KSPROPERTY_CAMERACONTROL_FOCUS
User-mode clients use the KSPROPERTY_CAMERACONTROL_FOCUS property to get or set a camera's focus setting. This property is optional.
Usage Summary Table
| Get | Set | Target | Property descriptor type | Property value type |
|---|---|---|---|---|
| Yes | Yes | Filter or node | KSPROPERTY_CAMERACONTROL_S or KSPROPERTY_CAMERACONTROL_NODE_S | LONG |
The property value (operation data) is a LONG that specifies the focus setting. This value is expressed in millimeters.
Caution
When writing or testing an app, you should be aware that in practice, some drivers define a custom range of focus values and custom step values that might not be based on typical units. Drivers might implement the focus control either physically or digitally.
Remarks
The Value member of the KSPROPERTY_CAMERACONTROL_S structure specifies the focus setting.
Every video capture minidriver that supports this property must define its own range and default value for this property.
Requirements
Header: ksmedia.h (include Ksmedia.h)