MediaInfo (Windows Embedded CE 6.0)

1/6/2010

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::SetAVTransportURI or 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 parser and 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

See Also

Reference

UPnP AV Structures
IAVTransport::GetMediaInfo
IAVTransport::SetAVTransportURI
IAVTransport::SetNextAVTransportURI
Medium
object (UPnP AV)
parser (UPnP AV)
wstring class (UPnP AV)