User Guide

  • 2021.1
  • 03/24/2021
  • Public Content
Contents

Connect to a Running Application (Windows* only)

You may configure Intel® GPA to detect running Windows* application(s), connect to them automatically, and analyze.
Automatic detection may be useful in the following cases:
  • When you analyze applications from game platforms (Steam*, Origin*, Epic Games*, and others) and IDEs (Visual Studio*, Unreal Editor*, and others).
  • To save time on starting up Intel GPA tools when you launch your application.
Known limitations:
  • Enabled
    Secure Boot
    setting blocks auto-detection. Either turn the feature off or consider starting the application directly from the Graphics Monitor (recommended).
  • Applications may crash unexpectedly.
  • Auto-detection is only available for
    Frame
    and
    Stream
    modes.

Auto-Detect Launched Apps with Graphics Monitor

To enable automatic detection of a running application, do one of the following:
  • Press
    Ctrl
    and click the Graphics Monitor icon in the taskbar notification area.
  • Click the
    Settings
    button in the upper right corner of the Graphics Monitor window and set the
    Auto-detect Launched Applications
    setting to
    ON
    .
As soon as you turn on automatic detection, the Graphics Monitor icon turns green: .
Whenever any application starts, Intel GPA attaches to it and the HUD automatically displays metrics as an overlay on the application window.

Attach to Specific Processes

Once you enable the
Auto-detect Launched Applications
option, Intel GPA connects to all the processes that use graphics APIs (DirectX*, Vulkan*), including web browsers and non-game applications. To change this, specify the applications that you want/do not want to profile with Intel GPA, once you start them:
  1. Turn off
    Automatic detection
    using Graphics Monitor.
  2. Go to the Intel GPA installation directory. By default, it is
    C:\Program Files\IntelSWTools\GPA.
  3. Add the application names you want to analyze to the
    InjectionList.txt
    file or add the application you do not want to analyze to
    InjectionSkipList.txt
    . When specifying file names, use the wildcard "*" to replace 0 or more characters, and skip the
    .exe
    extension. Example: "my*game", "basichlsl*".
  4. Save the files.
  5. In the Graphics Monitor
    Settings
    dialog box, turn on
    Auto-detect Launched Application
    .
As a result, whenever your application listed in
InjectionList.txt
starts, Intel GPA gets attached to that process and the HUD is enabled. The tool automatically displays metrics as an overlay on the application window. Applications listed in the
InjectionSkipList.txt
are not attached to Intel GPA.
If the
InjectionList.txt
file contains at least one item, the
InjectionSkipList.txt
file and all other running applications are ignored.

Connect to a Running Steam* App

To run your Steam (or any other supported game platform) application for performance analysis with Intel GPA, do the following:
  1. Shut down Steam.
  2. In the Graphics Monitor
    Settings
    dialog box, turn on
    Auto-detect Launched Applications
    .
  3. Re-launch Steam.
    Alternatively, you can browse to Steam from the Graphics Monitor's
    Application Executable with Command Line Arguments
    filed and click
    Start
    .
  4. Run an application from Steam.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.