Edit

Share via

KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_CONFIGCAPS

  • Article

The KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_CONFIGCAPS property ID that is defined in the KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY enumeration is used to query ROI capabilities.

Usage summary table

Scope Control Type

Version 1

Filter

Synchronous (read-only)

To query the ROI capabilities with the driver, the KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_CONFIGCAPS extended property control is sent to the driver along with a standard KSCAMERA_EXTENDEDPROP_HEADER structure followed by a KSCAMERA_EXTENDEDPROP_ROI_CONFIGCAPSHEADER structure, which is followed by one or more KSCAMERA_EXTENDEDPROP_ROI_CONFIGCAPS structures. The following list illustrates the data structure with two ROI config caps.

  • KSCAMERA_EXTENDEDPROP_HEADER

  • KSCAMERA_EXTENDEDPROP_ROI_CONFIGCAPSHEADER (ConfigCapCount = 2)

  • KSCAMERA_EXTENDEDPROP_ROI_CONFIGCAPS

  • KSCAMERA_EXTENDEDPROP_ROI_CONFIGCAPS

The table below contains the descriptions and requirements for the KSCAMERA_EXTENDEDPROP_HEADER structure fields when using the KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_CONFIGCAPS property of the extended ROI control.

Member Description

Version

This must be 1,

PinId

This must be KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF),

Size

This must be sizeof(KSCAMERA_EXTENDEDPROP_HEADER + sizeof(KSCAMERA_EXTENDEDPROP_ROI_CONFIGCAPSHEADER) + sizeof (KSCAMERA_EXTENDEDPROP_ROI_CONFIGCAPS) * ConfigCapCount.

Result

This must be 0.

Capability

This must be 0.

Flags

This is a read-only field. This must be 0.

Requirements

Header

 Ksmedia.h