IAVTransport (Windows CE 5.0)
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.
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:
- Retrieving an IConnectionManager instance using MediaRendererDevice::GetConnectionManager or MediaServerDevice::GetConnectionManager.
- 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
OS Versions: Windows CE 5.0 and later.
Header: Av_upnp.h.
Link Library: Av_upnp.lib.
C++ Namespace: av_upnp
See Also
UPnP AV Interface and Implementation Classes | ConnectionInfo | IAVTransportImpl | IConnectionManager | IConnectionManager::PrepareForConnection | IConnectionManager::GetCurrentConnectionInfo | IEventSource | IVirtualService | MediaRendererDevice::GetConnectionManager | MediaServerDevice::GetConnectionManager
Send Feedback on this topic to the authors