media-isidentical.md

title	description	ms.assetid	keywords	topic_type	api_name	api_location	api_type	ms.topic	ms.date	ms.custom
Media.isIdentical method	The isIdentical method retrieves a value indicating whether the supplied object is the same as the current one. | Media.isIdentical method	af3266d5-4ac2-4e8c-a9f6-44f7938e9c9d	isIdentical method Windows Media Player isIdentical method Windows Media Player , Media class Media class Windows Media Player , isIdentical method	apiref	Media.isIdentical	wmp.dll	COM	reference	4/26/2023	UpdateFrequency5

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	Wmp.dll

See also

Media Object