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

GetSetTargetProperty descriptor typeProperty value type

Yes

No

Filter

KSPROPERTY

KSCAMERA_EXTENDEDPROP_HEADER

 

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.

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.

MemberValue
Version1
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).
Size

sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_CAMERAOFFSET)

Result0
Capability0
Flags0

 

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)

See also

KSCAMERA_EXTENDEDPROP_HEADER
KSCAMERA_EXTENDEDPROP_CAMERAOFFSET

 

 

Send comments about this topic to Microsoft

Show: