マルチタッチ ドライバーにおける最上位レベルのコレクションの実装 (Windows 7)

複数入力デバイスのレポート記述子には、プライマリ デバイス用に少なくとも 1 つの最上位レベルのコレクションと、それとは別にマウス用の最上位レベル コレクションが含まれている必要があります。

お使いのデバイスが Windows 7 より前の Windows バージョンをサポートしている場合、レポート記述子には、最上位レベルのコレクションも含める必要があります。このコレクションには、デバイスを複数入力デバイス、単一入力デバイス、またはマウス デバイスとして構成するときに使用できる機能レポートが含まれます。 詳細については、レポート記述子を使用した機能検出のサポートに関するページをご覧ください。

たとえば、EloMT サンプル内で、EloMT.c ファイルに含まれるレポート記述子には、最上位レベルのコレクションが 3 つ含まれています。1 つ目のコレクションには 2 つの論理コレクション (サポートされている 2 つの物理コンタクトそれぞれに 1 つ) が含まれます。2 つ目は機能レポート (構成コレクションとも呼ばれます) であり、3 つ目はマウス サポートの使用法を指定しています。 このドライバーは、ハイブリッド モードを使用して、3 つ以上の同時コンタクトを引き続きサポートできる点に注意してください。 モードを選択する方法については、マルチタッチ ドライバーでのパケット レポート モードの選択に関するページをご覧ください。

Windows 7 上では、複数入力から情報を提供する HID レポートが、デジタイザーの使用法ページ上でコレクション アプリケーション (CA) 0x4 (タッチ スクリーン) を指定する必要があります。

デバイスがマルチタッチ データを送信するには、コンタクトごとに 1 つのレポートを使用します。また、マルチタッチ ドライバーでのパケット レポート モードの選択に関するページで説明したレポート モードを使用して、データをより効率的にレポートすることもできます。 タッチ デバイスのレポート記述子では、指 (0x22) CL (コレクション論理) を使用して、最上位レベルのコレクションで、データをグループ化して使用を制御する必要があります。一方、スタイラス (0x20) CL は、ペン関連の制御とデータ使用をグループ化するために使用する必要があります。

構成コレクションを使用すると、以前のバージョンの Windows で動作するようにデバイスを構成できます。 また、構成コレクションを使用して、お使いのタッチ デバイスをさまざまなモードで操作することもできます。 たとえば Windows Vista 上では、お使いのデバイスを既定でシングル タッチに設定できます。 Windows XP 上では、お使いのデバイスでマウスの機能を想定できます。 構成コレクションへのアクセス方法については、レポート記述子を使用した機能検出のサポートに関するページの "機能レポートの排他性" のサブトピックをご覧ください。