Windows 星形控制器輸入報告
本主題詳細說明WINDOWS 10版本 1607 和更新版本作業系統中用於星形控制器觸覺回饋支援的 HID 輸入報告。
主機會在從輸入報表擷取資料時使用下列用法:
member | 描述 | 頁面 | 識別碼 | 強制/選用 |
---|---|---|---|---|
按鈕 | 位於星形控制器上的按鈕狀態 | 0x09 | 0x01 | 強制性 |
撥號 | 星形控制器的相對旋轉 | 0x01 | 0x37 | 強制性 |
X | 接觸位置的 X 座標 | 0x01 | 0x30 | 選擇性 |
Y | 連絡人位置的 Y 座標 | 0x01 | 0x31 | 選擇性 |
寬度 | 連絡人周框方塊的寬度 | 0x0D | 0x48 | 選擇性 |
高度 | 連絡人周圍的周框方塊高度 | 0x0D | 0x49 | 選擇性 |
強制和 Windows 支援的選擇性使用方式
未報告所有強制使用狀況的任何裝置,都會以 Windows 星形控制器的形式運作。 Windows 主機會嚴格強制執行強制使用方式。 如果邏輯最大值尚未受到限制,則可以將其優化以減少描述項大小。
下列各節提供更多有關上表所呈現之強制和 Windows 支援的選擇性使用方式的詳細資料。
按鈕
用來指出星形控制器裝置上的主要按鈕何時被壓下。 這是以報表大小為 1 位的主要專案表示。 傳遞輸入報告時,應該在按下此按鈕時設定位,並在放開按鈕時清除。
撥號
用來指出星形控制器繞著自己的主軸的順時針旋轉。 傳遞輸入報表時,報告值應該是相對於上一個報表的旋轉大小。 如果星形控制器以順時針方向旋轉,如果星形控制器以逆時針方向旋轉,這個值將會是正數,如果星形控制器是以逆時針方向旋轉,則為負值。
必須指定實體範圍和邏輯範圍。 度或弧度可用於實體範圍。 不論是哪一種情況,邏輯範圍都必須夠大,才能報告精確度至少為一個小數位數的值。
X/Y
X 和 Y 會報告星形控制器螢幕上連絡人的座標。 這個座標代表相對於顯示器的連絡人中心。
報告 X 和 Y 的裝置也必須報告 Width 或 Height 使用量。 主機會使用報告座標,在連絡人周圍建置周框。
必須針對 X 和 Y 使用方式指定下列全域專案:
- 邏輯最小值
- 邏輯最大值
- 實體最小值
- 實體最大值
- 單位
- 單位指數
裝置和單位的實體範圍必須正確報告。 如果資訊不正確,裝置將無法正常運作。 裝置也必須報告報表描述元中所指定邏輯範圍內的資料。
X 和 Y 可為系統提供 Null 值,表示裝置目前沒有相對於顯示器的位置,方法是提供報告邏輯範圍以外的值,並將 Null 支援新增至使用量的輸入報告 , (位 6 {沒有 Null 位置 (0) |Null 狀態 (1) }) 。
寬度和高度
寬度和高度使用方式代表星形控制器接觸周圍周框方塊的寬度和高度。 寬度和高度應該定義為報表描述元中的常數。
系統假設 Windows 星形控制器裝置是迴圈的。 因此,不需要報告螢幕連絡人的寬度和高度。 如果支援高度或寬度,系統將會正確解譯連絡人的界限。 Windows 不支援寬度和高度具有不同值的星形控制器裝置。