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.
A version of this page is also available for
4/8/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::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

See Also