winsat dwm |
Applies To: Windows Server 2008 R2,Windows Server 2008,Windows Vista,Windows 7
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 |
|
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 dwm |
|
|
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.