Media Object
[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 Media object provides a way to specify or retrieve properties of a media item, using the following properties and methods.
The Media object supports the following properties.
| Property | Description |
|---|---|
| attributeCount | Retrieves the number of attributes that can be queried and/or set for the media item. |
| duration | Retrieves the duration in seconds of the current media item. |
| durationString | Retrieves a String value indicating the duration of the current media item in HH:MM:SS format. |
| error | Retrieves an ErrorItem object if the media item has an error condition. |
| imageSourceHeight | Retrieves the height of the current media item in pixels. |
| imageSourceWidth | Retrieves the width of the current media item in pixels. |
| markerCount | Retrieves the number of markers in the media item. |
| name | Specifies or retrieves the name of the media item. |
| sourceURL | Retrieves the URL of the media item. |
The Media object supports the following methods.
| Method | Description |
|---|---|
| getAttributeCountByType | Retrieves the number of attributes associated with the specified attribute name and language. |
| getAttributeName | Retrieves the name of the attribute corresponding to the specified index. |
| getItemInfo | Retrieves the value of the specified attribute for the media item. |
| getItemInfoByAtom | Retrieves the value of the attribute with the specified index number. |
| getItemInfoByType | Retrieves the value of the attribute corresponding to the specified attribute name, language, and index. |
| getMarkerName | Retrieves the name of the marker at the specified index. |
| getMarkerTime | Retrieves the time of the marker at the specified index. |
| isIdentical | Retrieves a value indicating whether the supplied object is the same as the current one. |
| isMemberOf | Retrieves a value indicating whether the specified media item is a member of the specified playlist. |
| isReadOnlyItem | Retrieves a value indicating whether the attributes of the specified media item can be edited. |
| setItemInfo | Sets the value of the specified attribute for the media item. |
The Media object is accessed through the following properties and methods.
| Object | Property or method |
|---|---|
| Controls | currentItem |
| Player | currentMedia, newMedia |
| Playlist | item |
Because it is the most common means of access, player.currentMedia is used for purposes of illustration in the reference syntax sections.
See also