Visual Studio でのネットワーク ケーブル経由でのカーネルモード デバッグの設定Setting Up Kernel-Mode Debugging over a Network Cable in Visual Studio

重要

この機能は、Windows 10 バージョン 1507、以降のバージョンの WDK でご利用いただけません。This feature is not available in Windows 10, version 1507 and later versions of the WDK.

Microsoft Visual Studio を使用して、設定し、イーサネット ネットワーク経由でのカーネル モードのデバッグを実行することができます。You can use Microsoft Visual Studio to set up and perform kernel-mode debugging over an Ethernet network. カーネル モードのデバッグを Visual Studio を使用するには、Windows Driver Kit (WDK) の Visual Studio と統合が必要です。To use Visual Studio for kernel-mode debugging, you must have the Windows Driver Kit (WDK) integrated with Visual Studio. 統合環境をインストールする方法については、次を参照してください。 Windows ドライバー開発します。For information about how to install the integrated environment, see Windows Driver Development.

Visual Studio を使用して、イーサネットのデバッグを設定する代わりに、自動的にセットアップを実行できます。As an alternative to using Visual Studio to set up Ethernet debugging, you can do the setup automatically. 詳細については、次を参照してください。設定を KDNET ネットワーク カーネル デバッグを自動的にします。For more information, see Setting Up KDNET Network Kernel Debugging Automatically.

イーサネット ネットワーク経由でのデバッグと、その他の種類のケーブル経由でのデバッグと比較して次の利点があります。Debugging over an Ethernet network has the following advantages compared to debugging over other types of cable:

  • ホストおよびターゲット コンピューターは、ローカル ネットワークに任意の場所に配置できます。The host and target computers can be anywhere on the local network.
  • 1 つのホスト コンピューターから多数のターゲット コンピューターのデバッグが容易になります。It is easy to debug many target computers from one host computer.
  • ネットワーク ケーブルは安価なすぐに利用できます。Network cable is inexpensive and readily available.
  • 2 台のコンピューターを指定するには、可能性は両方があることのイーサネット アダプターです。Given any two computers, it is likely that they will both have Ethernet adapters. 両方がシリアル ポートに、1394 ポートがある両方に低い可能性があります。It is less likely that they will both have serial ports or both have 1394 ports.

デバッガーを実行しているコンピューターと呼ばれる、ホスト コンピューターとは、デバッグ中のコンピューターと呼びます、対象のコンピュータします。The computer that runs the debugger is called the host computer, and the computer that is being debugged is called the target computer. ホスト コンピューターに Windows XP を実行する必要がありますまたはそれ以降、および 8 またはそれ以降、ターゲット コンピューターで Windows が実行する必要があります。The host computer must be running Windows XP or later, and the target computer must be running Windows 8 or later.

サポートされているネットワーク アダプターSupported network adapters

ホスト コンピューターは、任意のワイヤード (有線) またはワイヤレス ネットワーク アダプターを使用できますが、ターゲット コンピューターが Windows のツールをデバッグでサポートされているネットワーク アダプターを使用する必要があります。The host computer can use any wired or wireless network adapter, but the target computer must use a network adapter that is supported by Debugging Tools for Windows. サポートされているネットワーク アダプターの一覧は、次を参照してください。イーサネット Nic を Windows 8.1 でのネットワーク カーネル デバッグのサポートされているイーサネット Nic を Windows 10 でのネットワーク カーネル デバッグのサポートされているします。For a list of supported network adapters, see Supported Ethernet NICs for Network Kernel Debugging in Windows 8.1 and Supported Ethernet NICs for Network Kernel Debugging in Windows 10.

ホストおよびターゲット コンピューターの構成Configuring the host and target computer

  1. スイッチを使用して、適切なネットワーク ケーブルまたはネットワーク ハブに、ターゲット コンピューターのネットワーク アダプターを接続します。Connect the network adapter of the target computer to a network hub or switch using and appropriate network cable. 標準ケーブルまたはワイヤレス接続を使用して切り替えるまたはネットワーク ハブに、ホスト コンピューターのネットワーク アダプターを接続します。Connect the network adapter of the host computer to a network hub or switch using a standard cable or a wireless connection.

  2. 」の説明に従って、ホストとターゲット コンピューターの構成を開始ドライバーの展開のためにコンピューターをプロビジョニングし、テスト (WDK 8.1)します。Begin configuring your host and target computers as described in Provision a computer for driver deployment and testing (WDK 8.1).

  3. Visual Studio で、ホスト コンピューターで、コンピューターの構成 ダイアログ ボックスのような場合が選択コンピューターをプロビジョニングし、デバッガーの設定を選択します。On the host computer, in Visual Studio, when you come to the Computer Configuration dialog box, select Provision computer and choose debugger settings.

  4. 接続の種類、選択ネットワークします。For Connection Type, choose Network.

    スクリーン ショットのデバッガーの例を次のフィールドの値の設定を示す: 接続の種類、ターゲットの名前、およびバス パラメーター

    ポート番号では、既定値を受け入れるか、任意の値を入力します。For Port Number, accept the default value or fill in a value of your choice. 49152 ~ 65535 から任意の数を選択できます。You can choose any number from 49152 through 65535. 選択したポートを排他アクセスのホスト コンピューターで実行されているデバッガーでは開けません。The port that you choose will be opened for exclusive access by the debugger running on the host computer. ホスト コンピューター上で実行される他のアプリケーションで使用されていないポート番号を選択するように注意します。Take care to choose a port number that is not used by any other applications that run on the host computer.

      ネットワーク デバッグに使用できるポート番号の範囲は、会社のネットワーク ポリシーによって制限される可能性があります。Note  The range of port numbers that can be used for network debugging might be limited by your company's network policy. 制限とは何か、ホスト コンピューターから区別する方法はありません。There is no way to tell from the host computer what the limitations are. 会社のポリシーがネットワークのデバッグに使用できるポートの範囲を制限するかどうかを判断するには、ネットワーク管理者に確認します。To determine whether your company's policy limits the range of ports that can be used for network debugging, check with your network administrators.

    キー、自動的に生成された既定値を使用することを強くお勧めします。For Key, we strongly recommend that you use the automatically generated default value. ただし、使用する場合は、独自のキーを入力できます。However, you can enter your own key if you prefer. 詳細については、次を参照してください。独自のキーを作成するこのトピックで後述します。For more information, see Creating your own key later in this topic. ホスト IP既定値をそのまま使用します。For Host IP, accept the default value. これは、ホスト コンピューターの IP アドレスです。This is the IP address of your host computer.

    対象のコンピューターに 1 つだけのネットワーク アダプターがある場合は、おくことができますBus パラメーター空です。If your target computer has only one network adapter, you can leave Bus Parameters empty. ターゲット コンピューターに 1 つ以上のネットワーク アダプターがある場合は、対象のコンピューター デバイス マネージャーを使用して、PCI バス、デバイス、およびデバッグに使用するアダプターの関数の番号を確認します。If there is more than one network adapter on the target computer, use Device Manager on the target computer to determine the PCI bus, device, and function numbers for the adapter you want to use for debugging. Bus パラメーター、入力b.d.f場所bd、およびfはバス番号、デバイスの数、およびアダプターの関数の数。For Bus Parameters, enter b.d.f where b, d, and f are the bus number, device number, and function number of the adapter.

  5. 構成プロセスには数分かかりますが自動的に、コンピューターを再起動ターゲットまたは 2 回。The configuration process takes several minutes and might automatically reboot the target computer once or twice. プロセスが完了したら、クリックして完了します。When the process is complete, click Finish.

注意  ドッキング ステーションでは、ターゲット コンピューターがネットワーク デバッグ ドッキング ステーションの一部であるネットワーク アダプターを有効になっている必要がある場合では、ドッキング ステーションからコンピューターは削除しないでください。Caution  If your target computer is in a docking station, and you have network debugging enabled for a network adapter that is part of the docking station, do not remove the computer from the docking station. ドッキング ステーションから対象のコンピュータを削除する必要がある場合は、カーネルの最初のデバッグを無効にします。If you need to remove the target computer from the docking station, disable kernel debugging first. ターゲット コンピューター上のカーネル デバッグを無効にするには、管理者としてコマンド プロンプト ウィンドウを開きし、コマンドを入力しますオフ bcdedit/debugします。To disable kernel debugging on the target computer, open a Command Prompt window as Administrator and enter the command bcdedit /debug off. ターゲット コンピューターを再起動します。Reboot the target computer.

  ターゲット コンピューターに HYPER-V の役割をインストールする場合を参照してください。ネットワーク デバッグのセットアップ、バーチャル マシン ホストのします。Note  If you intend to install the Hyper-V role on the target computer, see Setting Up Network Debugging of a Virtual Machine Host.

ターゲット コンピューター上の dbgsettings を確認していますVerifying dbgsettings on the Target Computer

重要

BCDEdit を使用してブート情報を変更する前に、テスト用のコンピューターの BitLocker とセキュア ブートなどの Windows セキュリティ機能を一時的に中断する必要があります。Before using BCDEdit to change boot information you may need to temporarily suspend Windows security features such as BitLocker and Secure Boot on the test PC. テストが完了すると、これらのセキュリティ機能を再度有効にし、適切なセキュリティ機能を無効にするテスト PC を管理します。Re-enable these security features when testing is complete and appropriately manage the test PC, when the security features are disabled.

対象のコンピューターに管理者としてコマンド プロンプト ウィンドウを開きし、これらのコマンドを入力します。On the target computer, open a Command Prompt window as Administrator, and enter these commands:

bcdedit /dbgsettingsbcdedit /dbgsettings

bcdedit/enumbcdedit /enum

...
key                     RF8...KNE
debugtype               NET
hostip                  10.125.5.10
port                    50001
dhcp                    Yes
...
busparams               0.29.7
...

いることを確認debugtypeは NET とポートはホスト コンピューターで Visual Studio で指定したポート番号です。Verify that debugtype is NET and port is the port number you specified in Visual Studio on the host computer. 確認キー Visual Studio では、自動的に生成されたキー (または、指定した)。Also verify that key is the key that was automatically generated (or you specified) in Visual Studio.

入力した場合Bus パラメーター Visual Studio であることを確認busparams指定したバス パラメーターと一致します。If you entered Bus Parameters in Visual Studio, verify that busparams matches the bus parameters you specified.

用に入力した値が表示されない場合Bus パラメーター、このコマンドを入力します。If you do not see the value you entered for Bus Parameters, enter this command:

bcdedit /set "{dbgsettings}" busparams b . d . fbcdedit /set "{dbgsettings}" busparams b.d.f

場所bd、およびfバス、デバイス、および関数のデバッグに使用する、選択したターゲット コンピューター上のネットワーク アダプター数。where b, d, and f are the bus, device, and function numbers of the network adapter on the target computer that you have chosen to use for debugging.

以下に例を示します。For example:

bcdedit /set "{dbgsettings}" busparams 0.29.7bcdedit /set "{dbgsettings}" busparams 0.29.7

デバッグ セッションの開始Starting the Debugging Session

  1. Visual Studio で、ホスト コンピューター上で、ツール] メニューの [選択プロセスにアタッチします。On the host computer, in Visual Studio, on the Tools menu, choose Attach to Process.
  2. トランスポート、選択Windows カーネル モードのデバッガーします。For Transport, choose Windows Kernel Mode Debugger.
  3. 修飾子、以前に構成されているターゲット コンピューターの名前を選択します。For Qualifier, select the name of the target computer that you previously configured.
  4. クリックしてアタッチします。Click Attach.

デバッガー、ファイアウォールを通過を許可します。Allowing the debugger through the firewall

最初のネットワーク デバッグ接続を確立しようとは、ファイアウォール経由でデバッグ アプリケーション (Microsoft Visual Studio) を許可するように求め可能性があります。When you first attempt to establish a network debugging connection, you might be prompted to allow the debugging application (Microsoft Visual Studio) through the firewall. Windows のクライアント バージョンは、プロンプトを表示しますが、Windows のサーバー バージョンはプロンプトを表示できません。Client versions of Windows display the prompt, but Server versions of Windows do not display the prompt. 3 つのすべてのネットワークの種類のチェック ボックスをオンして、プロンプトに応答します。 ドメイン、プライベート、および公開します。Respond to the prompt by checking the boxes for all three network types: domain, private, and public. プロンプトが表示されない場合、または、プロンプトが使用可能なときに、ボックスを確認しなかった場合は、コントロール パネルを使用して、ファイアウォール経由のアクセスを許可する必要があります。If you do not get the prompt, or if you did not check the boxes when the prompt was available, you must use Control Panel to allow access through the firewall. 開いているコントロール パネルの [>システムとセキュリティ、] をクリックアプリを Windows ファイアウォールを通過できますします。Open Control Panel > System and Security, and click Allow an app through Windows Firewall. アプリケーションの一覧で、ファイアウォールを介した Visual Studio を許可するのにチェック ボックスを使用します。In the list of applications, use the check boxes to allow Visual Studio through the firewall. Visual Studio を再起動します。Restart Visual Studio.

独自のキーを作成します。Creating Your Own Key

対象のコンピュータを保護するため、ホストとターゲットのコンピューター間で移動するパケットを暗号化する必要があります。To keep the target computer secure, packets that travel between the host and target computers must be encrypted. (Visual Studio の構成ウィザードによって提供される)、自動的に生成された暗号化キーを使用することを強くお勧め、対象のコンピュータを構成する場合)。We strongly recommend that you use an automatically generated encryption key (provided by the Visual Studio configuration wizard) when you configure the target computer). ただし、独自のキーを作成することができます。However, you can choose to create your own key. ネットワーク デバッグの使用ベース 36、ピリオドで区切られた 4 つの 64 ビット値として指定されている、256 ビット キー。Network debugging uses a 256-bit key that is specified as four 64-bit values, in base 36, separated by periods. 64 ビットの各値は 13 文字を使用して指定します。Each 64-bit value is specified by using up to 13 characters. 有効な文字は文字 a ~ z および 0 ~ 9 の数字です。Valid characters are the letters a through z and the digits 0 through 9. 特殊文字は使用できません。Special characters are not allowed. (ただし、厳密ではありません)、次の一覧が有効な例を示しますキー。The following list gives examples of valid (although not strong) keys:

  • 1.2.3.41.2.3.4
  • abc.123.def.456abc.123.def.456
  • dont.use.previous.keysdont.use.previous.keys

ネットワーク ケーブル経由でのデバッグのトラブルシューティングのヒントTroubleshooting Tips for Debugging over a Network Cable

アプリケーションのデバッグを許可するファイアウォールを通過する必要があります。Debugging application must be allowed through firewall

デバッガー (WinDbg または KD) ファイアウォール経由のアクセスが必要です。Your debugger (WinDbg or KD) must have access through the firewall. コントロール パネルを使用して、ファイアウォール経由のアクセスを許可することができます。You can use Control Panel to allow access through the firewall. 開いているコントロール パネルの [>システムとセキュリティ、] をクリックアプリを Windows ファイアウォールを通過できますします。Open Control Panel > System and Security, and click Allow an app through Windows Firewall. アプリケーションの一覧で、ファイアウォールを介した Visual Studio を許可するのにチェック ボックスを使用します。In the list of applications, use the check boxes to allow Visual Studio through the firewall. Visual Studio を再起動します。Restart Visual Studio.

ポート番号は、ネットワーク ポリシーで許可されている範囲内で指定する必要があります。Port number must be in range allowed by network policy

ネットワークのデバッグに使用できるポート番号の範囲は、会社のネットワーク ポリシーによって制限される可能性があります。The range of port numbers that can be used for network debugging might be limited by your company's network policy. 会社のポリシーがネットワークのデバッグに使用できるポートの範囲を制限するかどうかを判断するには、ネットワーク管理者に確認してください。To determine whether your company's policy limits the range of ports that can be used for network debugging, check with your network administrator.

ポート番号を変更する必要がある場合は、次の手順を使用します。Use the following procedure if you need to change the port number.

  1. ホスト コンピューター上の Visual Studio の [ドライバー] メニューで、 [Test (テスト)] > [Configure Computers (コンピューターの構成)] の順に選びます。On the host computer, in Visual Studio, on the Driver menu, choose Test > Configure Computers.
  2. テスト用コンピューターの名前を選択し、クリックしてします。Select the name of your test computer, and click Next.
  3. 選択コンピューターをプロビジョニングし、デバッガーの設定を選択します。Select Provision computer and choose debugger settings. [次へ] をクリックします。Click Next.
  4. ポート番号、ネットワーク管理者によって許可される範囲内にある数値を入力します。For Port Number, enter a number that is in the range allowed by your network administrator. [次へ] をクリックします。Click Next.
  5. 再構成プロセスは、数分を受け取り、対象のコンピュータを自動的に再起動されます。The reconfiguration process takes a few minutes and automatically reboots the target computer. プロセスが完了したら、クリックして完了します。When the process is complete, click Next and Finish.

ターゲット コンピューターに複数のネットワーク アダプターがある場合は、busparams を指定します。Specify busparams if target computer has multiple network adapters

対象のコンピューターに 1 つ以上のネットワーク アダプターがある場合は、バス、デバイス、および関数をデバッグするために使用するネットワーク アダプター数を指定する必要があります。If your target computer has more than one network adapter, you must specify the bus, device, and function numbers of the network adapter that you intend to use for debugging. バス パラメーターを指定するには、デバイス マネージャーを開き、デバッグに使用するネットワーク アダプターを探します。To specify the bus parameters, open Device Manager, and locate the network adapter that you want to use for debugging. ネットワーク アダプターのプロパティ ページを開き、バス番号、デバイスの数、および関数の数をメモしておきます。Open the property page for the network adapter, and make a note of the bus number, device number, and function number. 管理者特権でコマンド プロンプト ウィンドウで、次のコマンドを入力します。 ここbd、およびf bus、デバイス、および関数の数値を 10 進数形式では。In an elevated Command Prompt Window, enter the following command, where b, d, and f are the bus, device and function numbers in decimal format:

bcdedit -set "{dbgsettings}" busparams b . d . fbcdedit -set "{dbgsettings}" busparams b.d.f

ターゲット コンピューターを再起動します。Reboot the target computer.

関連トピックRelated topics

Visual Studio でのカーネル モード デバッグの設定Setting Up Kernel-Mode Debugging in Visual Studio

Windows 10 でのデバッグ ネットワーク カーネルのイーサネット Nic をサポートSupported Ethernet NICs for Network Kernel Debugging in Windows 10

Windows 8.1 でのデバッグ ネットワーク カーネルのイーサネット Nic をサポートSupported Ethernet NICs for Network Kernel Debugging in Windows 8.1

Windows 8 でのデバッグ ネットワーク カーネルのイーサネット Nic をサポートSupported Ethernet NICs for Network Kernel Debugging in Windows 8