PositionInfo (Compact 7)

3/12/2014

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 at the UPnP Forum AV web site.

  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 the UPnP Forum AV web site.

Requirements

See Also

Reference

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