Windows Media Player SDK banner art
PreviousNext

PARAM Element

The PARAM Element defines a custom parameter associated with a clip or show.

Syntax

<PARAM
   NAME="parameter name"
   VALUE="parameter value"
/>

Attributes 

  NAME

Name used to access the parameter value. The name can be any valid string.

  VALUE

Value associated with this parameter. It can be either a numeric or string value.

Parent/Child Elements

Hierarchy Elements
Parent elements ASX, ENTRY
Child elements None

Remarks

This element allows users to place additional information about each clip inside the ENTRY element that contains it. To retrieve metadata information specified in the playlist ENTRY for Windows Media Player 7 or later, use the Media.getItemInfo method. The Media.getItemInfo method retrieves the value of the VALUE attribute, given the name of the parameter. retrieve metadata information specified in the playlist ENTRY, using the GetMediaParameter method given the name of the parameter and an index number for the entry.

A parameter can also be associated with the show rather than an individual clip, by placing this element directly after the ASX tag. These items are referenced by their names and an index value of zero.

Note This ASX element is only available for Windows Media Player version 6.01 and later. The standard installation of Microsoft Internet Explorer 5 includes a compatible version of Windows Media Player.

Example Code

<ASX VERSION="3.0">
   <TITLE>Example Media Player Show</TITLE>
   <PARAM NAME="Director" VALUE="Jane D." />
   
   <ENTRY>
      <TITLE>Example Clip</TITLE>
      <REF href="http://samples.microsoft.com/media.asf" />
      <PARAM NAME="Location" VALUE="North America" />
      <PARAM NAME="Release Date" VALUE="March 1998" />
   </ENTRY>
   
   <ENTRY>
      <TITLE>Another Clip</TITLE>
      <REF href="http://samples.microsoft.com/more_media.asf" />
      <PARAM NAME="Location" VALUE="Japan">
      <PARAM NAME="Release Date" VALUE="December 1996" />
   </ENTRY>
</ASX>

See Also

PreviousNext


© 2000-2001 Microsoft Corporation. All rights reserved.