PositionInfo

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 strTrackURI member, 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 parser and 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

Reference

UPnP AV Structures
IAVTransport::GetPositionInfo
object (UPnP AV)
parser (UPnP AV)
wstring class (UPnP AV)