Updated: April 17, 2012
Applies To: Windows Vista, Windows Server 2008, Windows 7, Windows Server 2008 R2, Windows Server 2012, Windows 8
Analyzes performance during video playback and encoding using DirectShow media handling components.
For examples of how to use this command, see Examples.
-input <file name>
Required: Specify the file containing the video clip to be played or encoded. The file can be in any format that can be rendered by DirectShow.
Specify that the filter graph should be saved to a GraphEdit-compatible file before the assessment starts.
Specify that the filter graph should run at the normal playback speed of the input file. By default, the filter graph runs as fast as possible, ignoring presentation times.
Run the assessment in decode mode and show the contents of the file specified in -input in a window. By default, the assessment does not display any visible windows.
Run the assessment in decode mode and play any supplied audio content in the file specified in -input using the default DirectSound device. By default, audio playback is disabled.
-encode <PRX profile file name>
Re-encode the decoded content from the file specified in -input using the Windows Media codec. PRX profile file name is the name of a file containing the PRX profile that configures the encoder. This profile is created using the Windows Media Profile Editor application in the Windows Media Encoder tool set.
-saveas <output file name>
Save the results of the -encode operation to the specified output file name.
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.
Save information about physical volumes and logical disks as part of the <SystemConfig> section in the XML output.
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.
Include the local computer name in the XML output file.
Enumerate extra system information in the XML output file.
The following example assesses performance when decoding the sample video file included with WinSAT and saves the results in XML format in the file media.xml:
winsat media -input c:\windows\performance\winsat\winsat.wmv -xml media.xml
The following example assesses performance when decoding the sample video file included with WinSAT and re-encoding the video stream using the sample profile included with WinSAT:
winsat media -input c:\windows\performance\winsat\winsat.wmv -encode c:\windows\performance\winsat\winsat.prx
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.