Rediger

Del via


PROPSETID_VIDCAP_CAMERACONTROL

The PROPSETID_VIDCAP_CAMERACONTROL property set controls camera device settings. The controls it provides are a subset of the ITU T.RDC standard.

The KSPROPERTY_VIDCAP_CAMERACONTROL enumeration in Ksmedia.h specifies the properties of this set.

Support for this property set is optional and should be implemented only by minidrivers of devices that offer camera control settings. For more information, see the ITU website.

Prior to USB video class, this enumeration contained the following properties:

KSPROPERTY_CAMERACONTROL_EXPOSURE

KSPROPERTY_CAMERACONTROL_FOCUS

KSPROPERTY_CAMERACONTROL_IRIS

KSPROPERTY_CAMERACONTROL_ZOOM

KSPROPERTY_CAMERACONTROL_PAN

KSPROPERTY_CAMERACONTROL_ROLL

KSPROPERTY_CAMERACONTROL_TILT

With the introduction of the USB Video Class Driver, the following properties were added to the KSPROPERTY_VIDCAP_CAMERACONTROL enumeration.

KSPROPERTY_CAMERACONTROL_SCANMODE

KSPROPERTY_CAMERACONTROL_PRIVACY

KSPROPERTY_CAMERACONTROL_PANTILT

KSPROPERTY_CAMERACONTROL_PAN_RELATIVE

KSPROPERTY_CAMERACONTROL_TILT_RELATIVE

KSPROPERTY_CAMERACONTROL_ROLL_RELATIVE

KSPROPERTY_CAMERACONTROL_ZOOM_RELATIVE

KSPROPERTY_CAMERACONTROL_EXPOSURE_RELATIVE

KSPROPERTY_CAMERACONTROL_IRIS_RELATIVE

KSPROPERTY_CAMERACONTROL_FOCUS_RELATIVE

KSPROPERTY_CAMERACONTROL_PANTILT_RELATIVE

KSPROPERTY_CAMERACONTROL_FOCAL_LENGTH

KSPROPERTY_CAMERACONTROL_AUTO_EXPOSURE_PRIORITY

The DirectShow IAMCameraControl interface (see the Microsoft DirectShow documentation in the Windows Software Development Kit (SDK)) provides access to the properties of this set.

Note

Face-based ROI coordinates for 3A are calculated relative to the active field of view of the camera. If the field of view has been modified due to ue of a control such as Zoom, Pan or Tilt or Digital Window, the camera is responsible for mapping the provided 3A ROI coordinates back to the sensor's full field of view, considering the current zoom/pan window.

Windows 8 extended camera control properties

Starting with Windows 8, these additional properties are supported for user-mode clients to get or set a camera's control settings:

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY

KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_S

KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY

KSPROPERTY_CAMERACONTROL_VIDEO_STABILIZATION_MODE_PROPERTY