Share via

SENSOR_CATEGORY_ORIENTATION

  • 發行項

SENSOR_CATEGORY_ORIENTATION類別包含提供實體方向相關資訊的感應器。 指南針提供導覽方向，例如以磁北為基礎的指南針。 傾角計會測量斜率或高度。 距離感應器會測量某個物件與感應器的鄰近性。

平臺定義的感應器類型

此類別包含下列平臺定義的感應器類型。

感應器類型 Description
SENSOR_TYPE_AGGREGATED_DEVICE_ORIENTATION
 傳回四元數，在某些情況下會傳迴旋轉矩陣，以指定目前的裝置方向。 (旋轉矩陣是選擇性的。)
SENSOR_TYPE_AGGREGATED_QUADRANT_ORIENTATION
 以度為單位指定目前的裝置方向。
SENSOR_TYPE_AGGREGATED_SIMPLE_DEVICE_ORIENTATION
 將裝置方向指定為列舉。 (此類型會使用四個一般象限的其中一個來指定裝置方向：0 度、90 度逆時針、180 計數器順時針和 270 度逆時針。它也表示裝置的正面向上或向下方向。)
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 Description
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
Compass 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
相對於 true North 的補償指南針標題，以度為單位。 此補償會使標題角度的度量表示方式，就像指南針裝置在電腦所在的平面地面上配置一般。
SENSOR_DATA_TYPE_MAGNETIC_HEADING_MAGNETIC_NORTH_DEGREES
(PID = 13)
VT_R8
相對於磁北的未補償指南針標題，以度為單位。 標題角度的度量是以相對於安裝指南針裝置的平面測量來表示。
SENSOR_DATA_TYPE_MAGNETIC_HEADING_TRUE_NORTH_DEGREES
(PID = 14)
VT_R8
相對於 true North 的未補償指南針標題，以度為單位。 標題角度的度量是以相對於安裝指南針裝置的平面測量來表示。
SENSOR_DATA_TYPE_QUADRANT_ANGLE_DEGREES
(PID = 15)
VT_R8
匯總的象限方向，以度為單位。
SENSOR_DATA_TYPE_ROTATION_MATRIX
(PID = 16)
VT_VECTOR|VT_UI1[newline] 計數陣列，以 3x3 旋轉矩陣表示 3d 空間中的裝置方向。[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] x、y、z、quaternion 的值，代表 3d 空間中的裝置方向。 [newline] 向量類型的資料一律會序列化為 vt-ui1 ， (不帶正負號、1 位元組字元的陣列) 。 [換行] 此資料欄位必須包含每個值作為單精確度浮點數， (vt-r4) 。[newline] 此陣列中值的順序如下：[newline] [x，y，z，w][newline] quaternion 的 w 值限制為 [0，1]，而不是完整 [-1， 1]。 [換行] 所有旋轉都必須以正向 (來表示，而不是反向) 。[newline] 請注意，四元數的輸出應為標準化格式。 當四元數以正規化格式表示時，這些值會滿足下列條件：[newline]normalized quaternion 公式
SENSOR_DATA_TYPE_SIMPLE_DEVICE_ORIENTATION
(PID = 18)
VT_UI4
匯總的裝置方向，指定為列舉。 (列舉值會對應至四個象限的其中一個。)
SENSOR_DATA_TYPE_MAGNETOMETER_ACCURACY
(PID = 22)
VT_I4
磁力計精確度讀數，指定為列舉。

規格需求

需求 值
最低支援的用戶端
 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器
 都不支援
標頭
Sensors.h