通过

SENSOR_CATEGORY_ORIENTATION

SENSOR_CATEGORY_ORIENTATION类别包含提供有关物理方向信息的传感器。 指南针提供导航方向，例如基于磁北方向的指南针。 测斜仪测量斜率或高程。 距离传感器测量某个对象与传感器的邻近度。

平台定义的传感器类型

此类别包括以下平台定义的传感器类型。

传感器类型 说明
SENSOR_TYPE_AGGREGATED_DEVICE_ORIENTATION
 通过返回四元数指定当前设备方向，在某些情况下返回旋转矩阵。 (旋转矩阵是可选的。)
SENSOR_TYPE_AGGREGATED_QUADRANT_ORIENTATION
 以度为单位指定当前设备方向。
SENSOR_TYPE_AGGREGATED_SIMPLE_DEVICE_ORIENTATION
 将设备方向指定为枚举。 (此类型使用四个常规象限之一指定设备方向：0 度、90 度逆时针、180 逆时针和 270 度逆时针。它还指示 device 的正面朝上或朝下方向。)
SENSOR_TYPE_COMPASS_1D
{A415F6C5-CB50-49D0-8E62-A8270BD7A26C}
 单轴指南针。
SENSOR_TYPE_COMPASS_2D
{15655CC0-997A-4D30-84DB-57CABA3648BB}
 双轴指南针。
SENSOR_TYPE_COMPASS_3D
{76B5CE0D-17DD-414D-93A1-E127F40BDF6E}
 三轴指南针。
SENSOR_TYPE_DISTANCE_1D
{5F14AB2F-1407-4306-A93F-B1DBABE4F9C0}
 单轴距离传感器。
SENSOR_TYPE_DISTANCE_2D
{5CF9A46C-A9A2-4E55-B6A1-A04AAFA95A92}
 双轴距离传感器。
SENSOR_TYPE_DISTANCE_3D
{A20CAE31-0E25-4772-9FE5-96608A1354B2}
 三轴距离传感器。
SENSOR_TYPE_INCLINOMETER_1D
{B96F98C5-7A75-4BA7-94E9-AC868C966DD8}
 单轴测斜仪。
SENSOR_TYPE_INCLINOMETER_2D
{AB140F6D-83EB-4264-B70B-B16A5B256A01}
 双轴测斜仪。
SENSOR_TYPE_INCLINOMETER_3D
{B84919FB-EA85-4976-8444-6F6F5C6D31DB}
 三轴测斜仪。

平台定义的数据字段

此类别的平台定义属性键基于SENSOR_DATA_TYPE_ORIENTATION_GUID：

{1637D8A2-4248-4275-865D-558DE84AEDFD}

此类别包括以下平台定义的数据字段。

数据字段名称和 PID 说明
SENSOR_DATA_TYPE_ANGULAR_VELOCITY_X_DEGREES_PER_SECOND
(PID = 10)
VT_R8
陀螺测试仪 x 轴速度，以度/秒为单位。
SENSOR_DATA_TYPE_ANGULAR_VELOCITY_Y_DEGREES_PER_SECOND
(PID = 11)
VT_R8
陀螺测试仪 y 轴速度，以度/秒为单位。
SENSOR_DATA_TYPE_ANGULAR_VELOCITY_Z_DEGREES_PER_SECOND
(PID = 12)
VT_R8
陀螺测试仪 z 轴速度，以度/秒为单位。
SENSOR_DATA_TYPE_TILT_X_DEGREES
(PID = 2)
VT_R4
测斜仪 x 轴角度（以度为单位）。
SENSOR_DATA_TYPE_TILT_Y_DEGREES
(PID = 3)
VT_R4
测斜仪 y 轴角度（以度为单位）。
SENSOR_DATA_TYPE_TILT_Z_DEGREES
(PID = 4)
VT_R4
测斜仪 z 轴角度（以度为单位）。
SENSOR_DATA_TYPE_DISTANCE_X_METERS
(PID = 8)
VT_R4
X 轴距离（以米为单位）。
SENSOR_DATA_TYPE_DISTANCE_Y_METERS
(PID = 9)
VT_R4
Y 轴距离（以米为单位）。
SENSOR_DATA_TYPE_DISTANCE_Z_METERS
(PID = 10)
VT_R4
Z 轴距离（以米为单位）。
SENSOR_DATA_TYPE_MAGNETIC_FIELD_STRENGTH_X_MILLIGAUSS
(PID = 19)
VT_R8
磁力计 x 轴场强度，以毫瓦为单位。
SENSOR_DATA_TYPE_MAGNETIC_FIELD_STRENGTH_Y_MILLIGAUSS
(PID = 20)
VT_R8
磁力计 y 轴场强度，以毫瓦为单位。
SENSOR_DATA_TYPE_MAGNETIC_FIELD_STRENGTH_Z_MILLIGAUSS
(PID = 21)
VT_R8
磁力计 z 轴场强度，以毫瓦为单位。
SENSOR_DATA_TYPE_MAGNETIC_HEADING_X_DEGREES
(PID = 5)
VT_R4
指南针 x 轴方向，以度为单位。
SENSOR_DATA_TYPE_MAGNETIC_HEADING_Y_DEGREES
(PID = 6)
VT_R4
指南针 y 轴方向，以度为单位。
SENSOR_DATA_TYPE_MAGNETIC_HEADING_Z_DEGREES
(PID = 7)
VT_R4
指南针 z 轴方向，以度为单位。
SENSOR_DATA_TYPE_MAGNETIC_HEADING_COMPENSATED_MAGNETIC_NORTH_DEGREES
(PID = 11)
VT_R8
相对于磁北的补偿指南针方向（以度为单位）。 这种补偿使航向角度的测量表示为指南针设备平躺在电脑所在的平地上。
SENSOR_DATA_TYPE_MAGNETIC_HEADING_COMPENSATED_TRUE_NORTH_DEGREES
(PID = 12)
VT_R8
相对于真实北向的补偿指南针方向（以度为单位）。 这种补偿使航向角度的测量表示为指南针设备平躺在电脑所在的平地上。
SENSOR_DATA_TYPE_MAGNETIC_HEADING_MAGNETIC_NORTH_DEGREES
(PID = 13)
VT_R8
相对于磁北的无补偿指南针方向（以度为单位）。 航向角的度量表示为在指南针设备相对安装的平面上测量。
SENSOR_DATA_TYPE_MAGNETIC_HEADING_TRUE_NORTH_DEGREES
(PID = 14)
VT_R8
相对于真实北向的无补偿指南针方向（以度为单位）。 航向角的度量表示为在指南针设备相对安装的平面上测量。
SENSOR_DATA_TYPE_QUADRANT_ANGLE_DEGREES
(PID = 15)
VT_R8
聚合象限方向（以度为单位）。
SENSOR_DATA_TYPE_ROTATION_MATRIX
(PID = 16)
VT_VECTOR |VT_UI1[newline] 计数数组，表示设备在 3d 空间中的方向作为 3x3 旋转矩阵。[newline] 向量类型的数据始终序列化为 vt-ui1 ， (一个无符号的 1 字节字符数组) 。 此数据字段必须包含每个值作为单精度浮点数 (vt-r4) 。[newline] 表示为矩阵：[newline]图中显示了一个 3 x 3 矩阵，其值为 M11、M12、M13、M21、M22、M23、M31、M32、M33。在旋转矩阵数据字段数组中按顺序表示这些值：M11，M12，M13，M21，M22，M23，M31，M32，M33
请注意，对于实现对内置Windows 8 HID 传感器类驱动程序支持的设备，此数据字段是可选的。 如果只实现 SENSOR_DATA_TYPE_QUATERNION ，则会为发送的每个数据报告计算和填充 SENSOR_DATA_TYPE_ROTATION_MATRIX 。 未使用内置 HID 传感器类驱动程序的设备需要计算并公开 SENSOR_DATA_TYPE_QUATERNION 和 SENSOR_DATA_TYPE_ROTATION_MATRIX 传感器数据字段。
SENSOR_DATA_TYPE_QUATERNION
(PID = 17)
VT_VECTOR |VT_UI1[newline] 表示设备在 3d 空间中方向的四元数的 x、y、z、w 值。 [newline] 向量类型的数据始终序列化为 vt-ui1 ， () 的无符号 1 字节字符数组。 [newline] 此数据字段必须包含每个值作为单精度浮点数 (vt-r4) 。[newline] 此数组中值的顺序如下：[newline] [x，y，z，w][newline] 四元数的 w 值限制为 [0，1] 而不是完整的 [-1， 1]。 [newline] 所有旋转都必须以向前方向 (，而不是反向) 。[newline] 请注意，四元数的输出应采用规范化格式。 当四元数以规范化格式表示时，值将满足以下条件：[newline]规范化四元数公式
SENSOR_DATA_TYPE_SIMPLE_DEVICE_ORIENTATION
(PID = 18)
VT_UI4
聚合的设备方向，指定为枚举。 (枚举值对应于四个象限之一。)
SENSOR_DATA_TYPE_MAGNETOMETER_ACCURACY
(PID = 22)
VT_I4
磁力计精度读数，指定为枚举。

要求

要求 值
最低受支持的客户端
 Windows 7 [仅限桌面应用]
最低受支持的服务器
 无受支持的版本
标头
Sensors.h