Edit

KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOFRAMERATE

  • Article

This property gets the capture frame rate when the photo mode for the camera is sequence mode.

Usage Summary Table

Get Set Target Property descriptor type Property value type

Yes

No

Pin

KSPROPERTY

KSCAMERA_EXTENDEDPROP_HEADER

The property value (operation data) contains a KSCAMERA_EXTENDEDPROP_HEADER structure and a KSCAMERA_EXTENDEDPROP_VALUE structure. The photo frame rate in frames per second is 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 synchronous 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.

Member Value
Version 1
PinId Thi 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 frame rate.

Otherwise, 0.
Capability 0
Flags 0

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.

Requirements

Version

Available starting with Windows 8.1.

Header

 Ksmedia.h (include Ksmedia.h)

See also

KSCAMERA_EXTENDEDPROP_HEADER