WDFドライバータブ

このトピックでは、WDF 検証ツールの [ WDF ドライバー] ページについて詳しく説明します。 このページには、コンピューター上のすべての WDF ドライバーが一覧表示され、確認設定と、それらを使用するデバイスの設定を変更できます。 特定のドライバーに関心がある場合は、ここから始めます。

アプリケーションを起動すると、現在システム上にある WDF ドライバーとランタイム バージョンの一覧が表示されます。 各行には、ドライバー バイナリの名前、サービスの表示名、フレームワークのバージョン、KMDF ドライバーの場合は開始の種類が含まれます。

ドライバーを強調表示すると、現在そのドライバーを使用しているデバイスと、関連する UMDF ホスト プロセスが表示されます。 ホスト プロセス コントロールは、実行中の UMDF ドライバーが選択されている場合にのみ表示されます。

配色

ドライバーごとに、色分けされたアイコンは、KMDF、UMDF 1、または UMDF 2 を使用しているかどうかを示します。

カラー コードは、ドライバーの状態と、ドライバーの検証設定の変更を有効にするために必要な操作を示します。

• 青は、ドライバーが使用中であり、1 つ以上の PnP デバイスに関連付けられていることを示します。 変更を有効にするには、これらのデバイスを無効にして再び有効にする必要があります。 [ マイ環境設定] タブで、WDF 検証ツールでこれを行うかどうかを選択できます。これらのドライバーの場合は、関連付けられているデバイスの一覧が表示されます。
• 赤は、ドライバーが使用中ですが、PnP デバイスに関連付けられていないことを示します。 変更を有効にするには:
  • KMDF の場合は、再起動する必要があります。
  • UMDF の場合は、すべての UMDF ホスト プロセスを停止して再起動する必要があります。
• 緑は、ドライバーが現在使用されていないことを示します。 設定を変更すると、次回ドライバーが読み込まれると、変更が有効になります。

プリセット オプション

ドライバー固有の設定 (KMDF および UMDF 2) を持つドライバーの場合は、次のクイック オプション メニューのドライバー名を右クリックします。

• 既定の設定に設定します。
• ドライバー コードで WDF ブレークポイントと VERIFY マクロを有効にします。
• 推奨されるすべてのテスト設定（検証ツールを有効化、詳細設定と大きなIFRバッファー、下位レベルの検証）を有効にします。

ドライバーの設定を変更しても変更をコミットしていない場合、(*) はドライバー名の後に表示され、メニューには変更を元に戻すための追加オプションが含まれています。

ドライバーの個別検証設定の変更

カラー アイコンの左側にある [+] をクリックすると、ドライバーの現在の検証設定が表示されます。 個々のオプションを右クリックして変更できます。

ブール値の設定を右クリックすると切り替わります。 一部の設定では有効なオプションの一覧が表示され、他の設定では値を入力できる編集コントロールが表示されます。 無効な値を入力すると、アプリがビープ音を鳴らします。 Enter キーを押して新しい値を使用するか、コントロールの外側をクリックして変更を取り消します。

AllocateFailCount に 16 進数の値を入力し、HostTimeoutSeconds に 10 進値を入力する必要があります。

KMDF 検証ツールをオンにする必要がある機能を有効にし、 VerifierOn オプションが現在オフの場合、アプリはそれをオンにします。 手動で無効にすることもできます。 この場合、機能を説明するテキストは、検証ツールがオンだった場合の動作を示します。 設定の状態を説明するテキストの同様の変更は、設定が他の設定に依存している場合や、アプリ検証ツールまたはドライバー検証ツールの使用状況に依存するたびに表示されます。

デバイスの起動と停止、または新しいドライバーのインストールを行う場合は、WDF 検証ツールを再起動してインベントリを更新する必要があります。

[WDF ドライバー] ページで変更を加えた場合は、[WDF を使用したデバイス] ページにそれらの変更が反映されます。