Share via


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