付録 (touchpad-appendix)

Windows Precision Touchpad 検証ガイドの付録では、一般的なエラー メッセージと HID 固有のエラー メッセージに関する情報を提供します。

エラー メッセージ

エラー メッセージ番号	エラー メッセージ	説明
1	ユーザーが明示的に失敗しました。	オペレーターが、ホットキーを使用したイテレーションやテストに失敗しました。
2	失敗したイテレーションが多すぎます。	失敗したイテレーションが多すぎます。 失敗したイテレーションの数が含まれます。
3	予期しない時刻に入力を受信しました。	テストではデータを受信する予定がなかったものの、データを受信しました。 たとえば、これは Z 軸の高さの検出 テストで発生する可能性があります。
5	受信したコンタクトの数が多すぎます。	オペレーターが配置したコンタクトの数が少なすぎます。 検出されたコンタクトの数が含まれます。
6	受信したコンタクトの数が少なすぎます。	オペレーターが配置したコンタクトの数が多すぎます。 検出されたコンタクトの数が含まれます。
7	テストで十分なデータが受信されません。	コンタクト リフトでエラーが発生した場合は、テストでコンタクトが一定の期間持続する必要があるものの、その期間が時速しなかったことを示しています。 コンタクト ダウンでこれが発生した場合は、テストが最初のデータとしてゼロのコンタクト フレームを受信したことを示します。これは非静電容量式ボタンの押下によって発生する可能性がありますが、プロトコル エラー (デバイスが空のフレームを送信する) の可能性の方が高くなります。
9	予期しないコンタクトを受信しました。	特定の数のコンタクトを必要とするテストでは、これは、コンタクト アップの後にコンタクト ダウンが発生したことを示しています。 すべてのコンタクト ダウンは、すべてのコンタクト アップの前に発生する必要があります。
10	ジオメトリ データが予想される範囲を外れています。	Test.Geometry でのみ。 幅や高さが、テストで想定される範囲を外れています。 ハイメトリック単位で検出された幅と高さが含まれます。
11	コンタクトの配置のずれが大きすぎます。	接点の x/y の総変位が大きすぎます。 ハイメトリック単位で検出された配置のずれが含まれます。
12	操作が短すぎます。	操作の長さ (最初のコンタクト ダウンから最後のコンタクト アップまでの時間) が短すぎます。 ミリ秒単位で検出された操作の長さが含まれます。
13	操作が長すぎます。	操作の長さ (最初のコンタクト ダウンから最後のコンタクト アップまでの時間) が長すぎます。 ミリ秒単位で検出された操作の長さが含まれます。
14	パケットがエッジから離れすぎています。	最初のパケットがタッチパッドのエッジから離れすぎていたことを示しています。 ハイメトリック単位のエッジからの距離が含まれます。
15	コンタクトが直線で移動していません。	コンタクトが最適な線から乖離しすぎています。 ハイメトリック単位で検出された線からの最大の乖離が含まれます。
16	線が軸からずれすぎています。	Test.Linearity ファミリのテストにのみ適用されます。 X または Y での接点の変位が大きすぎました。 ハイメトリック単位のずれが含まれます。
17	ポイントの分離が十分ではありません。	Test.ConvergeDiverge ファミリのテストにのみ適用されます。 収束する場合、開始ポイントが互いに近づきすぎています。 分岐する場合、終了ポイントが互いに近づきすぎています。
18	ポイントの分離が大きすぎます。	Test.ConvergeDiverge ファミリのテストにのみ適用されます。 収束する場合、終了ポイントが互いに近づきすぎています。 分岐する場合、開始ポイントが互いに近づきすぎています。 ポイント間の距離をハイメトリック単位で含みます。
20	位置の差が大きすぎます。	テストで 2 つのパケットの位置の差が大きすぎます。 ハイメトリック単位で検出された差が含まれます。
23	デバイスがコンタクトの最小数をサポートしていません。	デバイスは、必要な最小数の接点をサポートしていません。 サポートされるコンタクトの数が含まれます。
24	デバイスがサポートするコンタクトの数が多すぎます。	デバイスが、必要な最大数を超えるコンタクトをサポートしています。 サポートされるコンタクトの数が含まれます。
25	パケットが想定された位置にありません。	Test.PositionalAccuracy ファミリのテストにのみ適用されます。 パケットの場所が必要な位置にないことを示します。 パケットの場所を Himetric 単位で含めます。
26	境界領域外にパケットがありません。	高精度のコンタクト装置を使用して直線を描画するテストでは、これは、線全体がタッチパッドの境界領域に含まれることを示しています。
27	パケットが後方に移動していることを確認しました。	Test.Linearity ファミリのテストにのみ適用されます。 パケット ストリームの残りの部分に関連して、パケットが後方に移動していたことを示しています。
28	DPI が低すぎます。	Test.InputResolution でのみ。 タッチパッド上の X/Y の論理範囲とその物理的な次元が、必要な DPI をサポートしていないことを示しています。 計算された DPI が含まれます。
29	クリア後に信頼度ビットが設定されたことを確認しました。	Test.Confidence でのみ。 信頼度ビットがコンタクトに対してクリアされた後に、コンタクトが信頼度ビットを設定したことを示しています。
30	信頼度ビットの設定が長すぎます。	Test.Confidence でのみ。 コンタクトの有効期間内の早い段階で信頼度ビットがクリアされなかったことを示しています。 ミリ秒単位で設定された信頼度ビットの時間の長さが含まれます。
31	見つかった論理座標の割合が低すぎます。	Test.InputResolution でのみ。 特定のイテレーションで受信したパケットの X 座標または Y 座標には、全体の範囲の最小パーセントが含まれる必要があります。 実際に見つかったパーセントが含まれます。
32	このテストは、管理者特権で実行する必要があります。	PTLogo は、このテストのために管理者特権で起動されている必要があります。
33	デバイスが選択的レポートをサポートしていません。	デバイスが選択的レポートをサポートしていません。
34	パケットが重複しています。	Test.Linearity ファミリのテストにのみ適用されます。 コンタクトが移動したものの、2 つの連続したパケットの X/Y の位置が同じであることを示しています。 検出された重複パケットのスキャン時間が含まれます。
35	論理座標が見つかりません。	Test.InputResolution でのみ。 必要な X 座標または Y 座標が、イテレーション中にパケットにより報告されなかったことを示しています。 論理単位の必要な座標が含まれます。
36	信頼度が常に設定されています。	Test.Confidence でのみ。 信頼度ビットがクリアされなかったことを示しています。
37	自動化により失敗しました。	テストは自動化によって失敗しました。
38	接触変位が小さすぎる。	接触の初期の X/Y 変位が小さすぎました。 ハイメトリック単位で検出された配置のずれが含まれます。
39	ボタンの状態が予期せず変化しました。	Test.RightClickReliabilityのみ。 タッチパッドからボタンのみの入力レポートを受信したときに発生します。
40	デバイスの高さが小さすぎます。	Test.DeviceHeightのみ。 タッチパッドの高さが小さすぎます。 検出された高さをミリメートル単位で含みます。
41	デバイスの幅が小さすぎます。	Test.DeviceWidthのみ。 タッチパッドの幅が狭すぎます。 検出された幅をミリメートル単位で含みます。

HID 固有のエラー メッセージ

Windows 高精度タッチパッドのデバイス テストに関連する HID 固有のエラー メッセージを次の表に示します。

HID エラー番号	エラー メッセージ	説明
1	X ビットのサイズが無効です。	Tx/Cx のビット カウントが [1, 32] の範囲外です。 C が存在する場合にのみチェックされます。
2	Y ビットのサイズが無効です。	Ty/Cy のビット カウントが [1, 32] の範囲外です。 C が存在する場合にのみチェックされます。
3	無効なパケット遷移です。	このエラー メッセージは、次のいずれかと共に表示されます。 o 「最後の移動場所が異なります」 特定のコンタクトの「チップ スイッチのクリア」レポートの座標が、「最後のチップ スイッチの設定」レポートの座標と同じではありません。 o 「チップオンがありません」 最初のレポートにチップ スイッチが設定されていないか、チップ スイッチが設定されていない行に 2 つのパケットがありました。 o 「チップがありません」 以前に報告されたフレームにあった、チップ スイッチが設定されたコンタクトが、現在のフレームで見つかりません。
4	スキャン時間が無効です。	このエラー メッセージは、次のいずれかと共に表示されます。 o 「(なし)」 デバイスでは、その記述子でのスキャン時間の使用はサポートされていません。 o 「(範囲)」 報告されたスキャン時間が論理範囲を超えています。 o 「(時間が 1% 以上超過し、 > 10 ms を超える差がある)」 フレームからフレームまでのスキャン時間が 1% 以上超過し、10 ms を超える差があります。 o 「( > 16.7 ms を超える差)」 フレームからフレームへのスキャン時間の差が、16.7 ms を超えています。 o 「(重複)」 スキャン時間が 2 つの連続したフレームで重複しています。 o 「(フレーム内の異なる値)」 特定のフレームで報告されたすべてのコンタクトについて、スキャン時間の値が同一ではありません。 o 「(ウォール クロックからの乖離)」 スキャン時間の差が、システム時間から乖離しすぎています。 スキャン時間の差がクロック時間の 5% を超えています。
5	X、Y が無効です。	このエラー メッセージは、次のいずれかと共に表示されます。 o 「(無効な T)」 C、幅、または高さが存在する場合、Tx や Ty が存在しないか、論理範囲内にありません。 o 「(無効な C)」 T、幅、または高さが存在する場合、Cx や Cy が存在しないか、論理範囲内にありません。 o 「(無効な T/C の組み合わせ)」 C、幅、高さで形成された境界ボックス内に T が含まれていません。
6	幅または高さが無効です。	このエラー メッセージは、次のいずれかと共に表示されます。 o 「」 幅と高さ (またはそのどちらか) が存在しているか、幅と高さ のどちらかが存在していないか、幅と高さ (またはそのどちらか) が論理範囲から外れています。 o 「(0)」 幅と高さ (またはそのどちらか) が存在しますが、幅と高さ (またはそのどちらか) の論理値がゼロでした。
8	コンタクト ID が無効です。	このエラー メッセージは、次のいずれかと共に表示されます。 o 「(なし)」 デバイスでは、その記述子での ContactID の使用はサポートされていません。 o 「(フレーム内の重複)」 1 つのフレームでコンタクト ID が重複しました (不完全なフレームが報告されたことが原因の場合があります)。
14	フレーム内にデータがありません。	フレームにコンタクトが存在しないため、物理ボタンは押下されていませんが、それ以前に物理ボタンが起動していません。
16	フレーム内のコンタクトの数が無効です。	フレーム内のコンタクトの数が、報告された実際のカウントと一致しません。
17	フレーム内のコンタクトの最大数を超えています。	フレーム内のコンタクトの数が、デバイスが MAX COUNT ごとにサポートするコンタクトの最大数を超えました。
18	サンプリング レートが範囲から外れています。	サンプリング レートが、報告されたコンタクトの数の許容範囲内に含まれていません。
21	実際のカウントが無効です。	デバイスでは、その記述子での 実際のカウント の使用はサポートされていません。
22	信頼度が無効です。	信頼度スイッチが設定されていません (テストは信頼度テストではありません)。

PTLogo コマンド ライン スイッチ

これらのスイッチは組み合わせて使用でき、デバッグ目的でのみ役立ちます。 これらのスイッチは、認定テストの実行では許可されません。

Switch	使用方法	目的
-startat #	"Ptlogo.exe –startat # test.foo.json" (# は、特定の .json テストで開始する特定のイテレーションを示します)	特定のテストで特定のイテレーションにスキップするために使用されます。
-NoHIDValidation	"Ptlogo.exe –noHidValidation test.foo.json"	特定のテストのバックグラウンド HID 検証を無効にする場合に使用します。
-noDesktop	"Ptlogo.exe –noDesktop test.foo.json"	起動したのと同じ入力デスクトップでテストを開始するために使用します。バックグラウンドまたは他のデバッグ ツールで digiinfo を実行する場合に便利です。
-alliters	"Ptlogo.exe –alliters test.foo.json"	許容される失敗したイテレーションの最大数を超えた場合でも、オペレーターがテストのすべてのイテレーションを実施するために使用されます。
-EnableHIDLogging	"Ptlogo.exe –enableHIDLogging test.foo.json"	特定のテスト中に HID ログを有効にして、障害の詳細なデバッグ用に HID.log ファイルを生成するために使用されます。