WacomKMDF ドライバー

説明

WacomKMDF ディレクトリには、サンプルの Wacom HID ミニ ドライバーの KMDF バージョンが含まれます。

WacomPen ドライバーは、Wacom Technology Corporation のペン デバイス用の HID ミニドライバーです。 これらは、16550 UART 互換インターフェイスを使用する電子入力デバイスです。 このようなデバイスがコンピューター システムにインストールされている場合、対応するドライバーは、下位レベルのデバイス フィルター ドライバーとして機能するシステム提供の Serial.sys ドライバーの上に読み込まれます。 対応するサンプル INF ファイルは Wacompen.inx から生成できます。 この INF ファイルは、デバイス ID が ACPI\WACF004 であるデバイスの WacomPen ドライバーをインストールします。 Wacompen.inf を使用してこの種類のデバイスをインストールするには、ACPI BIOS で ACPI\WACF004 のデバイス ID を指定する必要があります。

サンプル ドライバーは、次のディレクトリにあるコードを共有します。

• src\input\hiddigi\common ディレクトリには、WacomPen と EloMT のサンプル ドライバーに共通のコードが含まれます。

• src\input\hiddigii\util ディレクトリには、すべてのサンプル ドライバーに共通のユーティリティ関数が含まれます。 ユーティリティ関数は、トレース ドライバーの操作とエラー ログを処理します。

サンプル ドライバーは、KMDF でミニドライバーがネイティブにサポートされていない場合でも、HID デバイス用の KMDF ドライバーを記述する方法を示しています。 これは、WDM shim ドライバー (Hidkmdf.sys) によって実現されます。このドライバーは HIDCLASS ミニドライバーとして機能し、実際のドライバーはドライバー スタックのフィルターが低くなります。 それ以外の場合、新しいドライバー プロジェクト用にカスタマイズする方法が非常に簡単であるという点で、サンプルは WDM バージョンと非常に似ています。

サンプルのビルド

Windows ドライバー キットで標準のドライバー ビルド ツールを使用します。 ドライバー ディレクトリに build と入力します。 ビルド スクリプトは Wacomdigi.sys ドライバーを生成します。

インストール

ドライバー ファイル:

• Wacompen.inf

• Wacomdigi.sys

• Hidkmdf.sys (src\hid\hidusbfx2\hidmapper ディレクトリからビルド)

• <WDK ROOT>\redist\wdf\<プラットフォーム>\ からの WDF 共同インストーラー

ドライバーをインストールするには、ドライバー ファイルと INF ファイルを同じ場所にコピーします。 デバイス マネージャーで次の手順を実行します:

Windows XP Tablet PC エディションの場合:

1. デバイスを右クリックし、[ドライバーの更新] をクリックします。

2. [リストまたは特定の場所からインストール (詳細)] を選択し、[次へ] をクリックします。

3. [検索しません。インストールするドライバーを選択します] を選択し、[ディスク使用] をクリックします。

4. [ディスクからインストール] ダイアログ ボックスで、ドライバーと INF ファイルをコピーしたディレクトリのパスを入力し、[OK] をクリックします。

5. [完了] をクリックします。

Windows Vista および Windows 7 の場合:

1. デバイスを右クリックし、[ドライバーの更新] をクリックします。

2. [コンピューターを参照してドライバー ソフトウェアを検索します] リンクをクリックします。

3. [コンピューター上のデバイス ドライバーの一覧から選択します] リンクをクリックします。

4. [ディスク使用] をクリックします。

5. ドライバー ファイルの場所に移動し、INF ファイルをクリックします。

6. OK をクリックします。

コード ツアー

このセクションには、src\input\hiddigi ディレクトリ内のすべてのファイルのファイル マニフェストが含まれています。

ファイル マニフェスト

src\input\hiddigi\WacomKMDF

ファイル	説明
Errcodes.mc	イベント コードとメッセージが含まれます。
Pch.h	プリコンパイル済みヘッダー ファイル。
ソース	WDK ソース ファイルです。
Makefile	WDK ビルド環境のメイク ファイルです。
WacomPen.c	OEM 固有のコードが含まれます。
Oempen.c	OEM 固有のコードが含まれます。
WacomPen.h	OEM 固有の定義が含まれます。
WacomPen.rc	ドライバーのリソース ファイルです。
Wacompen.inx	INF ファイルの生成に使用される INX ファイルです。

src\input\hiddigi\common

ファイル	説明
hid.c	すべての内部 HIDClass IOCTL を処理します。
naturalInput.h	UART デジタイザー ドライバーの一般的な定義が含まれます。
Pnp.c	PnP と電源管理を処理します。
Serial.c	シリアル ポートを扱うすべての関数が含まれます。
Serial.h	シリアル ポートの定義が含まれます。

src\input\hiddigi\util

ファイル	説明
Errlog.c	すべてのエラー ログ関数が含まれます。
Errlog.h	エラー ログの定義が含まれます。
Wtrace.h	トレース マクロの定義です。 これは、必要に応じてトレースを有効にするために編集する必要があります。