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
| Requirement | Value |
|---|---|
| Version |
Windows Media Player version 7.0 or later. |
| DLL |
|