IAVTransport (Windows Embedded CE 6.0)

1/6/2010

This pure virtual class contains methods that expose the functionality provided by the UPnP AV AVTransport service. The AVTransport service manages access to a media stream. It can be used by MediaRenderer devices, which output the stream by playing audio, showing video, and so on, and MediaServer devices, which transfer the stream to MediaRenderer devices.

Syntax

class IAVTransport : public IVirtualService, 
      public IEventSource

Methods

The following table shows the methods for this class. This class also inherits the methods from the IVirtualService and IEventSource classes.

Method	Description
IAVTransport::GetCurrentTransportActions	Returns the transport actions valid at the current time.
IAVTransport::GetDeviceCapabilities	Returns information about the device capabilities associated with this AVTransport instance, including the supported playback and storage media.
IAVTransport::GetMediaInfo	Returns information about the currently playing media, including the number of tracks, the length, and so on.
IAVTransport::GetPositionInfo	Returns information about the current position of the transport associated with this AVTransport instance. This information includes track number, duration, track time, position of the transport in the track, and so on.
IAVTransport::GetTransportInfo	Returns information about the current transport state, including whether the transport is stopped, playing, or in another state.
IAVTransport::GetTransportSettings	Returns information about the current transport settings associated with this AVTransport instance, including play mode (normal, shuffle, repeat all, and so on) and recording quality.
IAVTransport::InvokeVendorAction	Enables AVTransport implementations and users to provide and invoke custom vendor-specific actions that aren't defined in the AVTransport DCP.
IAVTransport::Next	Advances the current media managed by this AVTransport instance to the next track.
IAVTransport::Pause	Pauses output of the media associated with this AVTransport instance.
IAVTransport::Play	Starts output of the media associated with this AVTransport instance, using the specified play speed.
IAVTransport::Previous	Moves the current media managed by this AVTransport instance to the previous track.
IAVTransport::Record	Starts recording of the media associated with this AVTransport instance.
IAVTransport::Seek	Starts seeking through the media associated with this AVTransport instance, using the specified seek unit and seek target.
IAVTransport::SetAVTransportURI	Specifies the URI of the media resource to be controlled by this AVTransport instance.
IAVTransport::SetNextAVTransportURI	Specifies the URI of the next media resource to be controlled by this AVTransport instance.
IAVTransport::SetPlayMode	Sets the current play mode for this AVTransport instance.
IAVTransport::SetRecordQualityMode	Sets the record quality for this AVTransport instance.
IAVTransport::Stop	Stops the output of the media associated with this AVTransport instance.

Obtaining a Pointer

This class is used by UPnP devices and control points.

UPnP AV devices implement the methods in this class to make their device hardware and other functionality available to UPnP control points. Rather than deriving directly from this class, devices can inherit from the provided IAVTransportImpl class, which provides useful implementations for some of the methods in this class.

Control points use this class to control UPnP AV devices. A control point obtains a pointer to an instance of this class by:

1. Retrieving an IConnectionManager instance using MediaRendererDevice::GetConnectionManager or MediaServerDevice::GetConnectionManager.
2. Calling IConnectionManager::PrepareForConnection to retrieve, among other things, an IAVTransport reference.

A control point can also retrieve a pointer to a class that implements this interface by calling IConnectionManager::GetCurrentConnectionInfo and then using the pAVTransport field in the returned ConnectionInfo structure.

Remarks

The methods in this class match the actions in the AVTransport service, with the exception of IAVTransport::InvokeVendorAction.

For more information about the AVTransport service, 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 Interface and Implementation Classes
ConnectionInfo
IAVTransportImpl
IConnectionManager
IConnectionManager::PrepareForConnection
IConnectionManager::GetCurrentConnectionInfo
IEventSource
IVirtualService
MediaRendererDevice::GetConnectionManager
MediaServerDevice::GetConnectionManager