Skip to content

Commit e188e65

Browse files
Fix issues in winui-perf.md
- Replace login-gated Windows Insider Preview ADK link with the stable ADK install page (learn.microsoft.com/windows-hardware/get-started/adk-install) - Update build reference from preview 'build 26020' to stable 'ADK 10.1.26100.1 and later' - Update stale NOTE: XAML Frame Analysis is no longer preview-only; it shipped in stable ADK 10.1.26100.1 (May 2024) - Remove stray 'ADK preview' wording from installation step - Fix grammar typo: 'all process' -> 'all processes' - Update ms.date to reflect corrections Co-authored-by: Copilot <[email protected]>
1 parent da43c6b commit e188e65

1 file changed

Lines changed: 5 additions & 5 deletions

File tree

hub/apps/performance/winui-perf.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: WinUI performance optimization
33
description: Learn how to use performance monitoring tools from the Windows Performance Toolkit to produce in-depth performance profiles of WinUI applications.
44
ms.topic: article
5-
ms.date: 03/06/2024
5+
ms.date: 06/10/2025
66
#Customer intent: As a Windows application developer, I want to improve the responsiveness of my WinUI application by finding slow UI thread frames to optimize.
77
---
88

@@ -35,12 +35,12 @@ WinUI logs ETW events that track the start and stop of each frame (shown in the
3535

3636
:::image type="content" source="images/wpa-generic-events.png" alt-text="Screenshot of the Windows Performance Analyzer showing the Generic Events table with a series of frame starts and stops.":::
3737

38-
To address this issue, a new "XAML Frame Analysis" table plugin is included with the [Windows Assessment Toolkit (ADK) preview](https://www.microsoft.com/software-download/windowsinsiderpreviewadk), build 26020 and later. This table calculates and shows the duration of each frame (along with other time-consuming operations).
38+
To address this issue, a new "XAML Frame Analysis" table plugin is included with the [Windows Assessment Toolkit (ADK)](https://learn.microsoft.com/windows-hardware/get-started/adk-install) 10.1.26100.1 and later. This table calculates and shows the duration of each frame (along with other time-consuming operations).
3939

4040
> [!NOTE]
41-
> While only the preview version of the Windows Performance Analyzer (WPA) has the "XAML Frame Analysis" table, the version of WPR used to take the trace does not matter.
41+
> The "XAML Frame Analysis" table requires Windows Performance Analyzer (WPA) from Windows ADK 10.1.26100.1 or later. The version of WPR used to take the trace does not matter.
4242
43-
Once the ADK preview is installed, the "XAML Frame Analysis" table must be enabled by editing the "perfcore.ini" config file in the WPA folder (typically, C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit\). To do this, close any open instances of WPA, open "perfcore.ini" in a text editor, add `perf_xaml.dll` to the list of dlls, and save and close the file. Restart WPA, which should now show the "XAML Frame Analysis" graph at the bottom of the System Activity section.
43+
Once the ADK is installed, the "XAML Frame Analysis" table must be enabled by editing the "perfcore.ini" config file in the WPA folder (typically, C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit\). To do this, close any open instances of WPA, open "perfcore.ini" in a text editor, add `perf_xaml.dll` to the list of dlls, and save and close the file. Restart WPA, which should now show the "XAML Frame Analysis" graph at the bottom of the System Activity section.
4444

4545
:::image type="content" source="images/wpa-xaml-frame-analysis.png" alt-text="Screenshot of the Windows Performance Analyzer showing the XAML Frame Analysis table at the bottom of the System Activity section.":::
4646

@@ -49,7 +49,7 @@ Once the ADK preview is installed, the "XAML Frame Analysis" table must be enabl
4949
The Xaml Frame Analysis supports two views (both views show the same columns):
5050

5151
- "Interesting Xaml Frames" (default) - Shows WinUI frames based on heuristics that identify those most likely to cause responsiveness problems. These correspond to regions that start with operations like WinUI initialization, frame navigation, or flyout display, and stop with the end of the next frame. These scenarios typically involve extensive changes to the UIElement tree and are the most susceptible to performance problems.
52-
- "All Xaml Info" - Shows all WinUI frames from all process found in the trace. For operations like a frame or a layout pass, the plugin automatically computes and displays the durations based on the Start and Stop events.
52+
- "All Xaml Info" - Shows all WinUI frames from all processes found in the trace. For operations like a frame or a layout pass, the plugin automatically computes and displays the durations based on the Start and Stop events.
5353

5454
The following screenshot highlights how to switch between Xaml Frame Analysis views.
5555

0 commit comments

Comments
 (0)