KSPROPERTY_CAMERACONTROL_EXTENDED_MAXVIDFPS_PHOTORES
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 |
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) |