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 the AVTransport service instance's current position.

Syntax 

		
struct PositionInfo
		
{
		
  unsigned long 
		
nTrack
		
;
		
  wstring	 
		
strTrackDuration
		
;
		
  wstring	 
		
strTrackMetaData
		
;
		
  wstring	 
		
strTrackURI
		
;
		
  wstring	 
		
strRelTime
		
;
		
  wstring	 
		
strAbsTime
		
;
		
  long		
		
nRelCount
		
;
		
  long		
		
nAbsCount
		
;
		
};

Members

nTrack

Sequence number of the currently selected track. Corresponds to the AVTransport CurrentTrack state variable.

strTrackDuration

Duration of the current track. Corresponds to the AVTransport CurrentTrackDuration state variable.

strTrackMetaData

Metadata for the current track, that represented by the strTrackURImember, in DIDL-Lite XML. Corresponds to the AVTransport CurrentTrackMetaData state variable. 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.

strTrackURI

URI of the current track. Can be used to retrieve data associated with this track using the ContentDirectory service instance provided by the MediaServer device. Corresponds to the AVTransport CurrentTrackURI state variable.

strRelTime

Current position, in time units, from the beginning of the current track. Corresponds to the AVTransport RelativeTimePosition state variable.

strAbsTime

Current position, in time units, from the beginning of the media. Corresponds to the AVTransport AbsoluteTimePosition state variable.

nRelCount

Current position, in a dimensionless unit, from the beginning of the current track. Corresponds to the AVTransport RelativeCounterPosition state variable.

nAbsCount

Current position, in a dimensionless unit, from the beginning of the media. Corresponds to the AVTransport AbsoluteCounterPosition state variable.

Remarks

You can retrieve information about the current position using IAVTransport::GetPositionInfo.

The members of this structure correspond to OUT parameters in the AVTransport service's GetPositionInfo action.

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