Share via


MediaCenter.AddSongToQueue Method

Adds a specified song to the user's queue for audio playback.

Note   This method has been deprecated.

Syntax

  MediaCenter.AddSongToQueue(sUrl)

Parameters

sUrl

Required. A String that specifies the location of the audio file to be added.

Return Value

A Boolean that indicates whether the song was added.

Remarks

Windows Media Center enables you to dynamically create a queue of audio files for the user to play in order. The queue starts with the currently playing song. If this method is invoked while no song is currently playing, then no queue exists, so Windows Media Center will simply play the song indicated (that song then becomes, in effect, a "queue" of one song). If the method is invoked while a queue exists, Windows Media Center will add the song to the end of the queue to play after any other songs in the queue finish playing.

If the user starts a queue in Windows Media Player, that queue will be maintained in Windows Media Center as long as the playback is not stopped by the user or by an HTML application.

Requirements

Platform: HTML application hosted within Windows XP Media Center Edition 2004 through Windows Vista

See Also