winsat dwm
Applies To: Windows Vista, Windows Server 2008, Windows 7, Windows Server 2008 R2, Windows Server 2012, Windows 8
Simulates the composition operations of the Desktop Window Manager and produces a graphics memory throughput (bandwidth) metric that correlates with the performance of desktop composition.
For examples of how to use this command, see Examples.
Syntax
winsat dwm
winsat dwm <parameters> [options]
Parameters
Parameters |
Description |
|---|---|
-normalw <n> |
Specify the number of textures used to represent normal windows in the simulation. Required when any other parameters are specified. |
-glassw <n> |
Specify the number of textures used to represent glass windows in the simulation. |
-time <n> |
Specify in seconds how long the assessment will run. Required when any other parameters are specified. |
-winwidth <n> |
Specify the window width in pixels. The default is 500. |
-winheight <n> |
Specify the window height in pixels. The default is 500. |
-noupdate |
Call lock and unlock on every window, but skip the CPU update of every pixel. |
-nodisp |
Specify that the assessment draws to an off-screen surface, so that the assessment is not visible while running. |
-nolock |
Skip locking and unlocking for all windows. This means that there is no window animation and the assessment is all fill-bound. |
-width <n> |
Specify the desktop (screen) width in pixels for the assessment. The default is 1024. |
-height <n> |
Specify the desktop (screen) height in pixels for the assessment. The default is 768. |
-fullscreen |
Specify that the D3D device should be created in full screen mode. By default, the D3D device is created in windowed mode. |
-v |
Send verbose output to STDOUT, including status and progress information. Any errors will also be written to the command window. |
-xml <file name> |
Save the output of the assessment as the specified XML file. If the specified file exists, it will be overwritten. |
-idiskinfo |
Save information about physical volumes and logical disks as part of the <SystemConfig> section in the XML output. |
-iguid |
Create a globally unique identifier (GUID) in the XML output file. |
-note "note text" |
Add the note text to the <note> section in the XML output file. |
-icn |
Include the local computer name in the XML output file. |
-eef |
Enumerate extra system information in the XML output file. |
Examples
The following example runs the formal DWM assessment, saves the performance data needed by the Desktop Window Manager to the registry, and restarts the Desktop Window Manager:
winsat dwmNote
This command is useful after upgrading to a driver that supports WDDM in order to ensure the Desktop Window Manager immediately takes advantage of the extended functionality.
The following example runs the DWM assessment with 10 normal windows and 4 glass windows for 10 seconds, writing verbose output and running in full screen mode.
winsat dwm -normalw 10 -glassw 4 -time 10 -v -fullscreen
Remarks
Membership in the local Administrators group, or equivalent, is the minimum required to use winsat. The command must be executed from an elevated command prompt window.
To open an elevated command prompt window, click Start, click Accessories, right-click Command Prompt, and click Run as administrator.