Windows Dev Center

Media Properties

Windows Portable Devices supports the following media properties.

PropertyVarTypeDescription
WPD_MEDIA_ALBUM_ARTISTVT_LPWSTRA string that identifies the artist performing the media.
WPD_MEDIA_AUDIO_ENCODING_PROFILEVT_LPWSTRA string that specifies an encoding profile. Media codecs may be encoded in accordance with a profile, which defines a particular encoding algorithm or optimization process.
WPD_MEDIA_BITRATE_TYPEVT_UI4A WPD_BITRATE_TYPES enumeration that further qualifies the bit rate of audio or video data.
WPD_MEDIA_BUY_NOWVT_BOOLA Boolean value that specifies whether the user wants to buy the content the next time an Internet connection is made.
WPD_MEDIA_BYTE_BOOKMARKVT_UI8Specifies a bookmark (a zero-based byte offset) that corresponds to the last position played or viewed on the given media.
WPD_MEDIA_COMPOSERVT_LPWSTRThe composer, if the composer and performer are different.
WPD_MEDIA_COPYRIGHTVT_LPWSTRA string that provides copyright information about the object.
WPD_MEDIA_DESCRIPTIONVT_LPWSTRA 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_URLVT_LPWSTRA 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_DURATIONVT_UI8The duration of the content, in milliseconds.
WPD_MEDIA_EFFECTIVE_RATINGVT_UI4A 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_PROFILEVT_LPWSTRA 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_GENREVT_LPWSTRA null-terminated, human-readable string indicating the genre to which this media belongs.
WPD_MEDIA_GUIDVT_LPWSTRSpecifies a 128-bit globally unique identifier (GUID).
WPD_MEDIA_HEIGHTVT_UI4A value that specifies the height of the main resource (typically, a video or image), in pixels. See WPD_MEDIA_WIDTH.
WPD_MEDIA_LAST_BUILD_DATEVT_DATEA date specifying the last time a series in a mediacast was changed or edited.
WPD_MEDIA_LAST_ACCESSED_TIMEVT_DATEA value that specifies the date and time that the media was last accessed on the device.
WPD_MEDIA_MANAGING_EDITORVT_LPWSTRA null-terminated, human-readable string that indicates 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_GENREVT_UI4A WPD_META_GENRES enumeration that describes the type of media.
WPD_MEDIA_OBJECT_BOOKMARKVT_LPWSTRSpecifies the WPD_OBJECT_ID for the last object viewed or played.

This property applies to playlists and mediacasts.

WPD_MEDIA_OWNERVT_LPWSTRA null-terminated, human-readable string that indicates 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_RATINGVT_LPWSTRA null-terminated, human-readable string that indicates the parental rating of the media file. This is typically a Motion Picture Association of America (MPAA) rating.
WPD_MEDIA_RELEASE_DATEVT_DATEThe date that the content was originally released.
WPD_MEDIA_SAMPLE_RATEVT_UI4The encoding sample rate, in samples per second, for the content.
WPD_MEDIA_SKIP_COUNTVT_UI4The 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_URLVT_LPWSTRA null-terminated, human-readable string that indicates the source URL for the given media.

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

WPD_MEDIA_STAR_RATINGVT_UI4A 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_DESCRIPTIONVT_LPWSTRA 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_TITLEVT_LPWSTRA 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_IDVT_LPWSTRAn ID that is used to identify a piece of content to an online subscription service. Typically, this is set by the client rather than the driver or device.
WPD_MEDIA_TIME_BOOKMARKVT_UI8Specifies a bookmark (in milliseconds) that corresponds to the last position played or viewed on the given media.
WPD_MEDIA_TIME_TO_LIVEVT_UI8Specifies the time (in minutes) until the next content update.
WPD_MEDIA_TITLEVT_LPWSTRThe 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_BITRATEVT_UI4The bit rate of the object.
WPD_MEDIA_USE_COUNTVT_UI4The total number of times this media has been played or viewed on the device.
WPD_MEDIA_USER_EFFECTIVE_RATINGVT_UI4A 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_WEBMASTERVT_LPWSTRA null-terminated, human-readable string that indicates 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_WIDTHVT_UI4A value that specifies the width of the main resource (typically, a video or image), in pixels. See WPD_MEDIA_HEIGHT.
WPD_MEDIA_ARTISTVT_LPWSTRA value that identifies the media artist.

 

Requirements

Header

PortableDevice.h

See also

WPD Properties and Attributes

 

 

Community Additions

ADD
Show:
© 2015 Microsoft