Edit

KSPROPERTY_CAMERACONTROL_EXTENDED_MAXVIDFPS_PHOTORES

  • Article

This property control sets or retrieves the maximum frame rate possible on the capture (preview) video pins at a particular photo resolution.

Usage Summary Table

Get Set Target Property descriptor type Property value type

Yes

Yes

Pin

KSPROPERTY

KSCAMERA_EXTENDEDPROP_HEADER

The property value (operation data) contains a KSCAMERA_EXTENDEDPROP_HEADER structure and a KSCAMERA_MAXVIDEOFPS_FORPHOTORES 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 or Capability members of KSCAMERA_EXTENDEDPROP_HEADER for this property.

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

This property control is synchronous and not cancelable.

Remarks

Getting the property

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 The pin ID for the photo pin.
Size

sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_MAXVIDEOFPS_FORPHOTORES)
Result 0
Capability 0
Flags 0

The Result member of KSCAMERA_EXTENDEDPROP_HEADER is always set to 0 for a get operation.

When the property data is requested, the driver will receive the PhotoResWidth and PhotoResHeight members ofKSCAMERA_MAXVIDEOFPS_FORPHOTORES set with the requested resolution. The driver will set the frames per second values for the specified resolution.

If capture or preview is not supported by the camera, the frames per second members must be set to 0.

Requirements

Version

Available starting with Windows 8.1.

Header

 Ksmedia.h (include Ksmedia.h)

See also

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_MAXVIDEOFPS_FORPHOTORES