winsat d3d
Applies To: Windows 7, Windows Server 2008, Windows Server 2008 R2, Windows Vista
Assesses a system's ability to run D3D based applications such as games.
For examples of how to use this command, see Examples.
Syntax
winsat d3d <parameters>
Parameters
| Parameter | Description |
|---|---|
-objs |
The primitives used in the assessment are spheres. The parameter specifies the theta and phi quantization. Increasing this number causes more shader processing to occur. |
-sradius |
Specifies the radius of the spheres. A smaller radius will reduce the number of pixels drawn for that sphere while keeping the overhead of that sphere constant. |
-totalobj |
Total number of spheres in the scene. A large number of objects, combined with a small object size, results is an assessment that is batch limited. |
-texw |
Width and height of the textures created by the assessment as a power of 2. |
-totaltex |
The total number of textures that WinSAT will create. If the number of textures is less than the total number of objects that require a texture, then WinSAT will re-use the textures in the scene. If there are more textures that are required in the scene then WinSAT will iterate over the list using as many as is needed for this frame. This means that all textures will be used eventually. |
-texpobj |
This is the number of textures each sphere requires to render. |
-batchcnt |
Having large batches reduces driver time and tends to make the application fill rate limited. Conversely, having many small batches causes more driver overhead. |
-time |
Number of seconds to run the assessment. |
-out |
Specifies a path to a file to save the results along with the arguments to WinSAT. |
-width |
Width and Height of the window the app is running in. On XP, this is the screen resolution, on Vista it will be similar, but will not run in exclusive mode. |
-vs <profile> |
Forces the use of a particular vertex shader profile. The assessment is not guaranteed to run correctly when forced into using a particular shader model. |
-ps <profile> |
Forces the user of a particular pixel shader profile. The assessment is not guaranteed to run correctly when forced to use a particular shader model. |
-fps <n> |
In full screen mode, limits the refresh rate (frames per second) to the nearest rate supported by the card. |
-rendertotex <n> |
Render to texture float <n>. Simulate multiple-stage off-screen texture rendering. WinSAT will cycle through the specified number of rendertargets. |
-rtdelta <n> |
When rendering with render targets, the delta defines how far back in the render target circular buffer the assessment will go to set a previous render target as a texture. The default is 1. |
-fullscreen |
Specifies that the D3D device should be created in full screen mode. |
-noalpha |
Turns off back buffer alpha blending. |
-NoDisp |
Sets the window to "not visible" so that the assessment draws to an off-screen surface. |
-texshader |
Use the texture shader that samples up to 16 textures and adds them together instead of the default simple shader. |
-alushader |
Use the alu shader that loads up to two textures and computes an intensive lighting formula instead of the default simple shader. |
-fixedseed |
Seeds rand with a fixed number in order to run the exact same assessment multiple times. |
-nozwarming |
Disables the z-buffer warming used to make the results consistent for non-alpha assessments. |
-ref |
Forces software rasterization of the assessment. This option can decrease the speed of the assessment. |
-noetw |
Disables ETW tracing. Use this option if you intend to do your own ETW logging and do not want the log stopped when the assessment runs. |
-noclear |
Disables the call to clear in the OnFrameRender function. |
-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 assesses performance with 20 total spheres and 10 rendered textures using the alu shader, without back buffer alpha blending and in full screen mode, for 10 seconds, sending verbose output to stdout.
winsat d3d -totalobj 20 -objs C(20) -totaltex 10 -texpobj C(1) -alushader -noalpha -fullscreen -v -time 10
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.