Media.isIdentical method

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The isIdentical method retrieves a value indicating whether the supplied object is the same as the current one.

Syntax

bRetVal = Media.isIdentical(
  media
)

Parameters

media [in]

Media object to compare with the current Media object.

Return value

This method returns a Boolean.

Examples

The following JScript example uses Media.isIdentical to check whether a media item named newMedia is the same as the current media item. If they are not the same, the new media item is played. Otherwise, the current media continues to play uninterrupted. The Player object was created with ID = "Player".

// Check the new media item to see if it matches the current one.
if (newMedia.isIdentical(Player.currentMedia) != true){

   // Change the current media to the new media item.
   Player.currentMedia = newMedia;

   // Play the new media item.
   Player.controls.play();
}

Requirements

See also

Media Object