KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW
The field of view property describes the current Field of View (FOV) of the camera along with the pitch angle of the camera position.
Usage Summary Table
| Get | Set | Target | Property descriptor type | Property value type |
|---|---|---|---|---|
Yes |
No |
Filter |
The property value (operation data) contains a KSCAMERA_EXTENDEDPROP_HEADER structure and a KSCAMERA_EXTENDEDPROP_FIELDOFVIEW structure.
The total property data size is sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_FIELDOFVIEW). The Size member of KSCAMERA_EXTENDEDPROP_HEADER is set to this total property data size.
The Capability and Flags members of KSCAMERA_EXTENDEDPROP_HEADER are not used for this property.
If the driver cannot determine the correct field of view for the camera, the driver must not indicate support for this property.
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 | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF). |
| Size | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_FIELDOFVIEW) |
| Result | 0 |
| Capability | 0 |
| Flags | 0 |
The driver sets the focal length information for the FOV in the KSCAMERA_EXTENDEDPROP_FIELDOFVIEW structure.
Requirements
Version |
Available starting with Windows 8.1. |
Header |
Ksmedia.h (include Ksmedia.h) |