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.

Additional references