Expand Minimize

KSPROPERTY_CAMERACONTROL_S_EX structure

Specifies a camera control operation, including setting the flash, the image pin control properties, the region of interest in the image, or video stabilization. This structure describes filter-based properties in the PROPSETID_VIDCAP_CAMERACONTROL property set.

Supported starting with Windows 8.

Syntax


typedef struct {
  KSPROPERTY Property;
  LONG       Value;
  ULONG      Flags;
  ULONG      Capabilities;
  RECT       FocusRect;
} KSPROPERTY_CAMERACONTROL_S_EX, *PKSPROPERTY_CAMERACONTROL_S_EX;

Members

Property

Specifies an initialized KSPROPERTY structure that describes the property set, property ID, and request type.

Value

Specifies the value of the property. This member is read/write.

Flags

Indicates, for Get requests, the current setting for the specified property from the values listed below. Indicates, for Set requests, the desired setting for the specified property from the values listed below. This member can be a bitwise OR of the following values that are defined in Ksmedia.h:

ValueMeaning
KSPROPERTY_CAMERACONTROL_FLAGS_AUTO

Indicates that the setting is controlled automatically. If the driver receives this value, it should set the camera control synchronously to automatic mode and then return.

KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL

Indicates that the setting is controlled manually. If the driver receives this value, it should set the camera control synchronously to manual mode and then return.

KSPROPERTY_CAMERACONTROL_FLAGS_ASYNCHRONOUS

Indicates whether the driver should perform the camera control operation asynchronously—where the application has issued a command for the driver to set up the camera control settings in advance of taking a picture.

This flag must be set only if either KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL or KSPROPERTY_CAMERACONTROL_FLAGS_AUTO are set.

If this flag value and and the KSPROPERTY_CAMERACONTROL_FLAGS_AUTO flag value are both set, the driver should initiate a worker thread to start one requested control operation and should reject all other requests for the same operation until it has completed the first one. After the operation has successfully completed, the driver should trigger the KSEVENTSETID_CameraAsyncControl event.

 

Capabilities

If set, indicates that when the application submits a query, the driver should return the value of the Capabilities member of the appropriate camera control structure from the following list.

FocusRect

A RECT structure that specifies the rectangular region in which the device should set the focus. This structure is available only to Classic Windows applications.

Remarks

When a requested camera focus operation is completed or is canceled, the driver should generate an event specified by the KSEVENT_CAMERACONTROL_FOCUS enumeration value.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

Ksmedia.h (include Ksmedia.h)

See also

KSEVENT_CAMERACONTROL
KSPROPERTY
KSPROPERTY_CAMERACONTROL_FLASH_S
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S
KSPROPERTY_CAMERACONTROL_VIDEOSTABILIZATION_MODE_S
RECT

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft