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. Note |
|---|
|
The assessment will return an error if -show or -play is present in the same command as -encode. |
|
-saveas <output file name> | Save the results of the -encode operation to the specified output file name. Note |
|---|
|
The assessment will return an error if -saveas is present but -encode is not. |
|
-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.