KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE

This property provides the maximum capture frame rate for a camera when it is in photo sequence mode.

Usage Summary Table

GetSetTargetProperty descriptor typeProperty value type

Yes

Yes

Pin

KSPROPERTY

KSCAMERA_EXTENDEDPROP_HEADER

 

The property value (operation data) contains a KSCAMERA_EXTENDEDPROP_HEADER structure and a KSCAMERA_EXTENDEDPROP_VALUE structure. The maximum photo frame rate in frames per second is set or returned as value in KSCAMERA_EXTENDEDPROP_VALUE.

There are no flags set in the Flags member of KSCAMERA_EXTENDEDPROP_HEADER for this property.

The total property data size is sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). The Size member of KSCAMERA_EXTENDEDPROP_HEADER is set to this total property data size.

This property control is asynchronous and not cancelable.

Remarks

When responding to a KSPROPERTY_TYPE_GET request, the driver sets the members of the KSCAMERA_EXTENDEDPROP_HEADER to the following.

MemberValue
Version1
PinIdThe pin ID for the photo pin.
Size

sizeof(KSCAMERA_EXTENDEDPROP_HEADER) +

sizeof(KSCAMERA_EXTENDEDPROP_VALUE)

Result

An error value resulting from the attempt to read the max frame rate.

Otherwise, 0.

CapabilityKSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL
Flags0

 

The frame rate value is set in the Ratio member of KSCAMERA_EXTENDEDPROP_VALUE. Ratio.HighPart contains the numerator of the frame rate and Ratio.LowPart contains the denominator of the frame rate.

When the driver is in photo sequence mode, it may be necessary to limit the maximum frame rate of the photo capture. This is to ensure that “moment in time” capture scenarios, with a certain number of history frames, are contained within a configured time span. For example, based on memory constraints, if the application wishes to capture 1 second worth of past history, it’s necessary to cap the capture rate so only N number of frames are needed.

When set, the driver must use the frame rate provided even if the camera can capture frames fast then the requested rate. If necessary, the driver can drop extra frames to accommodate the requested rate.

Requirements

Version

Available starting with Windows 8.1.

Header

Ksmedia.h (include Ksmedia.h)

 

 

Send comments about this topic to Microsoft

Afficher:
© 2014 Microsoft