KSPROPERTY_CAMERACONTROL_EXTENDED_CAMERAANGLEOFFSET
The camera angle offset property provides read-only information about the pitch and yaw angle of the camera position. The pitch and yaw angle is defined to be an offset from horizontal and vertical axis.
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_CAMERAOFFSET structure.
The total property data size is sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_CAMERAOFFSET). 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
If the camera sensor and the gyro sensor are both housed in the same physical chassis, it is recommended that the camera driver report the proper offset angle, which may be 0 degrees. If the camera sensor and the gyro sensor are not housed in the same physical chassis, drivers are recommended to not indicate support for this property.
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_CAMERAOFFSET) |
| Result | 0 |
| Capability | 0 |
| Flags | 0 |
The driver sets the angle offsets the KSCAMERA_EXTENDEDPROP_CAMERAOFFSET structure.
Requirements
Version |
Available starting with Windows 8.1. |
Header |
Ksmedia.h (include Ksmedia.h) |