Share via


Media Properties

banner art

Previous Next

Media Properties

Windows Portable Devices supports the following media properties.

Property VarType Description
WPD_MEDIA_BITRATE_TYPE VT_UI4 A WPD_BITRATE_TYPES enumeration that further qualifies the bit rate of audio or video data.
WPD_MEDIA_ALBUM_ARTIST VT_LPWSTR A string that identifies the artist performing the media.
WPD_MEDIA_BUY_NOW VT_BOOL A Boolean value that specifies whether the user wants to buy the content the next time an Internet connection is made.
WPD_MEDIA_BYTE_BOOKMARK VT_UI8 Specifies a bookmark (a zero-based byte offset) that corresponds to the last position played or viewed on the given media.
WPD_MEDIA_COMPOSER VT_LPWSTR The composer, if the composer and performer are different.
WPD_MEDIA_COPYRIGHT VT_LPWSTR A string that provides copyright information about the object.
WPD_MEDIA_DESCRIPTION VT_LPWSTR A description for the given object.

Where the WPD_MEDIA_SUB_DESCRIPTION property may describe a single piece of content, this property will describe a collection of related media.

WPD_MEDIA_DESTINATION_URL VT_LPWSTR A null-terminated, human-readable string indicating the URL for an object. (This URL identifies the content that will appear if the user clicks on the object.)

Mediacast objects often use this property to specify the location of related information.

WPD_MEDIA_DURATION VT_UI8 The duration of the content, in milliseconds.
WPD_MEDIA_EFFECTIVE_RATING VT_UI4 A number between 1 and 100, inclusive, that rates the content, where 1 is the lowest value. This value is based on usage statistics that are not set explicitly by the user.
WPD_MEDIA_ENCODING_PROFILE VT_LPWSTR A profile name, as defined by the particular codec that is used. If the codec does not require a specific profile name, you should instead specify audio information in the appropriate properties.
WPD_MEDIA_GENRE VT_LPWSTR A null-terminated, human-readable string indicating the genre to which this media belongs.
WPD_MEDIA_GUID VT_LPWSTR Specifies a 128-bit globally unique identifier (GUID).
WPD_MEDIA_HEIGHT VT_UI4 A value that specifies the height of the main resource (typically a video or image), in pixels. See WPD_MEDIA_WIDTH.
WPD_MEDIA_LAST_BUILD_DATE VT_DATE A date specifying the last time a series in a mediacast was changed or edited.
WPD_MEDIA_LAST_ACCESSED_TIME VT_DATE A value that specifies the date and time that the media was last accessed on the device.
WPD_MEDIA_MANAGING_EDITOR VT_LPWSTR A null-terminated, human-readable string indicating the e-mail address of the media's managing editor.

Mediacast objects often use this property to specify the managing editor of an RSS channel or series.

WPD_MEDIA_META_GENRE VT_UI4 A WPD_META_GENRES enumeration that describes the type of media.
WPD_MEDIA_OBJECT_BOOKMARK VT_LPWSTR Specifies the WPD_OBJECT_ID for the last object viewed or played.

This property applies to playlists and mediacasts.

WPD_MEDIA_OWNER VT_LPWSTR A null-terminated, human-readable string indicating the e-mail address of the media's owner.

Mediacast objects often use this property to specify the owner of an RSS channel or series.

WPD_MEDIA_PARENTAL_RATING VT_LPWSTR A null-terminated, human-readable string indicating the parental rating of the media file. This is typically a Motion Picture Association of America (MPAA) rating.
WPD_MEDIA_RELEASE_DATE VT_DATE The date that the content was originally released.
WPD_MEDIA_SAMPLE_RATE VT_UI4 The encoding sample rate, in samples per second, for the content.
WPD_MEDIA_SKIP_COUNT VT_UI4 The total number of times this media was queued for playback, but explicitly skipped by the user. This may be used to automatically calculate a user rating or modify content updating rules.
WPD_MEDIA_SOURCE_URL VT_LPWSTR A null-terminated, human-readable string indicating the source URL for the given media.

Mediacast objects often use this property to specify where the content originated.

WPD_MEDIA_STAR_RATING VT_UI4 A number between 0 and 5 that rates the content, where 0 is unrated, 1 is the lowest rating, and 5 is the highest rating. This value is entered explicitly by the user.
WPD_MEDIA_SUB_DESCRIPTION VT_LPWSTR A subordinate description for the given object. This property is often used to provide additional information about content.

Where the WPD_MEDIA_DESCRIPTION property may describe a collection of related media, this property will describe a single piece of content.

WPD_MEDIA_SUB_TITLE VT_LPWSTR A subtitle for the object. If the object is an episode title in a series, this would be the episode title, and WPD_MEDIA_TITLE would be the series name.
WPD_MEDIA_SUBSCRIPTION_CONTENT_ID VT_LPWSTR An ID that is used to identify a piece of content to an online subscription service. This is typically set by the client rather than the driver or device.
WPD_MEDIA_TIME_BOOKMARK VT_UI8 Specifies a bookmark (in milliseconds) that corresponds to the last position played or viewed on the given media.
WPD_MEDIA_TIME_TO_LIVE VT_UI8 Specifies the time (in minutes) until the next content update.
WPD_MEDIA_TITLE VT_LPWSTR The title of the content. If the object is an episode in a series, this would be the series title, and WPD_MEDIA_SUB_TITLE would be the episode name.
WPD_MEDIA_TOTAL_BITRATE VT_UI4 The bit rate of the object.
WPD_MEDIA_USE_COUNT VT_UI4 The total number of times this media has been played or viewed on the device.
WPD_MEDIA_USER_EFFECTIVE_RATING VT_UI4 A number between 1 and 100 that rates this content, with 1 being the lowest. This value is set explicitly by the user. The default value is 0, indicating that this value has not been set.
WPD_MEDIA_WEBMASTER VT_LPWSTR A null-terminated, human-readable string indicating the e-mail address of the media's webmaster.

Mediacast objects often use this property to specify the webmaster of an RSS channel or series.

WPD_MEDIA_WIDTH VT_UI4 A value that specifies the width of the main resource (typically a video or image), in pixels. See WPD_MEDIA_HEIGHT.
WPD_MEDIA_ARTIST VT_LPWSTR A value that identifies the media artist.

Requirements

Header: Defined in PortableDevice.h

See Also

Previous Next