Analyzes performance during video playback and encoding using DirectShow media handling components.
For examples of how to use this command, see Examples.
Syntax
winsat media <-input <file name>> <parameters>
Parameters
Parameters | Description | ||||
---|---|---|---|---|---|
-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. |
||||
-dumpgraph |
Specify that the filter graph should be saved to a GraphEdit-compatible file before the assessment starts. |
||||
-ns |
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. |
||||
-show |
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. |
||||
-play |
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.
|
||||
-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 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
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.