DLNASourceURI Attribute

[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 DLNASourceURI attribute is the universal resource identifier (URI) of the item.

Applies To

• Audio Items
• Other Items
• Photo Items
• Playlist Items
• Video Items

Remarks

If the item is in the current user's local library, this attribute, the SourceURL attribute, and the value returned by IWMPMedia::get_sourceURL are all the same.

If the item is not in the current user's local library, but belongs to a remote library, this attribute is an identifier of the form dlna-playsingle://xxx.

You can pass a dlna-playsingle URI to the IWMPCore3::newMedia method to obtain an IWMPMedia interface that enables you to view the media item's metadata and potentially edit the media item's star rating. Note, however, that the dlna-playsingle URI must be for a content directory service (CDS) that Windows Media Player has already discovered. The newMedia method will not initiate UPnP discovery and search for the CDS.

You can edit the star rating of a media item in a remote library only if the remote library supports the edit operation. Remote libraries hosted on a computer running Windows 7 support the edit operation. Remote libraries hosted on a computer running a Windows operating system earlier than Windows 7 do not support the edit operation.

Requirements

See also

Attribute Reference