Media Properties
Windows Portable Devices supports the following media properties.
| Property | VarType | Description |
|---|---|---|
| WPD_MEDIA_ALBUM_ARTIST | VT_LPWSTR | A string that identifies the artist performing the media. |
| WPD_MEDIA_AUDIO_ENCODING_PROFILE | VT_LPWSTR | A 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_TYPE | VT_UI4 | A WPD_BITRATE_TYPES enumeration that further qualifies the bit rate of audio or video data. |
| 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 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_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 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_RATING | VT_LPWSTR | A 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_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 that indicates 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. Typically, this is 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 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_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
| Requirement | Value |
|---|---|
| Header |
|
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for