Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This structure contains information about media content.
Syntax
struct MediaInfo { unsigned long nNrTracks ; wstring strMediaDuration ; wstring strCurrentURI ; wstring strCurrentURIMetaData ; wstring strNextURI ; wstring strNextURIMetaData ; wstring strPlayMedium ; wstring strRecordMedium ; wstring strWriteStatus ; }; |
Members
- nNrTracks
-
Number of tracks controlled by this AVTransport instance. Corresponds to the AVTransport NumberOfTracks state variable.
- strMediaDuration
-
Duration of the media represented by the AVTransport instance's AVTransportURI state variable. Corresponds to the AVTransport CurrentMediaDuration state variable.
- strCurrentURI
-
URI of the current media. Corresponds to the AVTransport AVTransportURI state variable.
- strCurrentURIMetaData
-
Metadata for the current media, in DIDL-Lite XML. Corresponds to the AVTransport AVTransportURIMetaData state variable. Only set if the media information was provided in the call to IAVTransport::SetAVTransportURIor IAVTransport::SetNextAVTransportURI.
For more information about DIDL-Lite, see the ContentDirectory documentation referenced in UPnP AV DCP Documentation. To manipulate DIDL-Lite XML in the UPnP AV Framework, use parserand object.
- strNextURI
-
URI of the media to be played after the current media is finished playing. Corresponds to the AVTransport NextAVTransportURI state variable.
- strNextURIMetaData
-
Metadata for the media to be played after the current media is finished playing. Corresponds to the AVTransport NextAVTransportURIMetaData state variable.
- strPlayMedium
-
Storage medium of the media represented by the AVTransport instance's AVTransportURI state variable. Contains strings that have constants described in Medium. Corresponds to the AVTransport PlaybackStorageMedium state variable.
- strRecordMedium
-
Storage medium where the media represented by the AVTransport instance's AVTransportURI state variable is recorded if the Record action is invoked. Contains strings that have constants described in Medium. Corresponds to the AVTransport RecordStorageMedium state variable.
- strWriteStatus
-
Write protection status of the current media. Corresponds to the AVTransport RecordMediumWriteStatus state variable.
Remarks
You can retrieve media information about the current media being played by an AVTransport service instance using IAVTransport::GetMediaInfo.
The members of this structure correspond to OUT parameters in the AVTransport service's GetMediaInfo action.
The media content and information stored in instances of this structure vary depending on the value of the AVTransport service instance's AVTransportURI state variable. For example, the AVTransportURI can be a single item (like a song), or a collection of items (like a CD or playlist).
For more information about the actions and state variables defined by the UPnP AV DCP, see UPnP AV DCP Documentation.
Requirements
Header | av_upnp.h |
Library | Av_upnp.lib |
Windows Embedded CE | Windows CE 5.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |