Intel® System Debugger User Guide

ID Date Version Classification
648476 10/17/2024 Confidential
Document Table of Contents

Setting Up the Extension

Follow the steps below to start using Intel(R) Debug Extensions for WinDbg* for Microsoft* Hyper-V support.

Enable Intel(R) Virtualization Technology (Intel(R) VT) for IA-32, Intel(R) 64 and Intel(R) Architecture in BIOS

  1. Power on the system and open the BIOS.

  2. Open the Processor submenu. The processor settings menu may be located under any of Chipset, Advanced CPU configuration, or Northbridge tabs.

  3. Enable Intel(R) Virtualization Technology (Intel(R) VT) for IA-32, Intel(R) 64 and Intel(R) Architecture. The settings might depend on the OEM and system BIOS.

  4. If the option is available, enable Intel(R) Virtualization Technology (Intel(R) VT) for Directed I/O (Intel(R) VT-d).

  5. Click Save and exit the BIOS.

Enable Microsoft* Hyper-V on Windows* 10

System Requirements
  • Windows* 10 Enterprise, Pro, or Education 64-bit Processor.

  • CPU support for Virtual Machine Monitor Node Extension (Intel(R) Virtualization Technology (Intel(R) VT) for Connectivity (Intel(R) VT-c) on Intel CPUs).

  • Minimum of 4 GB memory.

Note:

Microsoft Hyper-V is built into Windows* OS as an optional feature, no direct download needed.

Enable Microsoft Hyper-V to create virtual machines on Windows* 10 using any way suggested below:

  • Enable Microsoft Hyper-V using Windows* PowerShell:

    1. Launch the Windows PowerShell console as Administrator.

    2. Run the following command:

      Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
      
    3. When the installation is completed, reboot the system.

  • Enable Microsoft Hyper-V through Settings:

    Note:

    The Hyper-V role cannot be installed on Windows* 10 Home.

    1. Open Windows Settings and navigate to Apps > Apps & features.

    2. On the right, click Programs and Features under Related settings.

    3. Select Turn Windows features on or off.

    4. Check the Hyper-V root box:

      hyperv

    5. Click OK and exit the settings.

Configure the Target Windows* OS

  1. On the target system, execute the following commands from the command line:

    bcdedit /debug on
    bcdedit /set hypervisordebug on
    bcdedit /set hypervisorlaunchtype auto
    

    Additionally, if you want to debug the process of loading the hypervisor, run the following command:

    bcdedit /set bootdebug on
    
  2. Reboot the target system.

To support Microsoft Hyper-V environment within the Virtual machine monitor (VMM) context or guest context, Extended Page Tables (EPT) address translation is fully integrated. Thus, all dbgeng use cases are transparently supported.

Note:

The following virtualization-related symbols are currently available only to the customers with a special NDA contract signed with Microsoft:

  • storvsp.pdb

  • vhdparser.pdb

  • passthroughparser.pdb

  • hvix64.pdb

  • hvloader.pdb

Without a .pdb file, the debugger cannot resolve the function names or any global objects in the context of the symbols enumerated above. Beside the symbol resolution support, other features are available for all users.