This file provides detailed instructions on how to install the WindowsPerf tool. It covers all the necessary steps, including system requirements, downloading the tool, and executing the installation process. By following the guidelines in this document, users can ensure a smooth and successful installation of WindowsPerf, enabling them to leverage its powerful performance monitoring and analysis capabilities.
⚠️ See Known Installation Issues for troubleshooting.
Native Windows On Arm hardware is required for WindowsPerf to install and operate correctly.
⚠️ Please note that WindowsPerf will not work correctly (or you may not be able to install the Kernel driver) on VMs (virtual machines).
- Download the latest WindowsPerf zipped package from the release page.
- Unzip the
windowsperf-bin-x.y.z.zipfile to a local folder. - Navigate to the
wperf-driversub-directory that contains the WindowsPerf Kernel Driver files. - From the command line as
Administrator, execute the commandwperf-devgen.exe install:
> wperf-devgen.exe install
For more details, see the Driver Installation section in the wperf-devgen.exe documentation. Example:
-
After the driver is successfully installed, you can start using the
wperf.exeuser-space application. There's no need to use Administrator privileges for this. -
To check your driver and user-space application compatibility, run the following command:
> wperf.exe --version
This command will display the version of wperf.exe, which can help you verify if it's compatible with the installed driver. If you encounter any issues or need further assistance, feel free to ask here.
If you no longer require the use of WindowsPerf, you have the option to uninstall the wperf-driver from your system. Detailed instructions for the driver uninstallation process can be found in the Driver uninstallation section of the WindowsPerf documentation.
Example:
> wperf-devgen uninstall
If you see below error when you try to run wperf-devgen.exe:
⚠️ "The application was unable to start correctly (0xc000007b). Click OK to close this application."
Please refer to A Windows Error 0xC000007B article.
Usually errors like these are due to missing vcredist files. We suggest downloading the updated ones from Microsoft's page, for example Latest Microsoft Visual C++ Redistributable Version.
If you see below error when you try to run wperf-devgen.exe:
⚠️ "The code execution cannot proceed because MSVCP140.dll was not found. Reinstalling the program may fix this problem."
Please refer to VCRUNTIME140.dll and MSVCP140.dll missing in Windows 11 article.
Usually errors like these are due to missing MSVCP140.dll and VCRUNTIME140.dll files. We suggest downloading the updated ones from Microsoft's page, for example Latest Microsoft Visual C++ Redistributable Version.