IAVTransport::Play
A version of this page is also available for
4/8/2010
This method starts output of the media associated with this AVTransport instance, using the specified play speed.
Syntax
virtual DWORD Play(
LPCWSTR pszSpeed
) = 0;
Parameters
- pszSpeed
[in] Speed of playback, in a string format that represents a fraction of normal speed. For example, 1, 1/2, 2, -1, and so on. Corresponds to the TransportPlaySpeed state variable. Supported speeds are stored in the AllowedValueList state variable.
Return Value
Custom implementations can return appropriate error codes. Should return SUCCESS_AV if the method succeeds. Otherwise, should return an error code defined in WinError.h or UPnP.h, or one of the UPnP AV-specific return values specified in UPnPAVError, especially the following errors documented for this action in the AVTransport DCP documentation:
- ERROR_AV_UPNP_AVT_INVALID_TRANSITION
- ERROR_AV_UPNP_AVT_NO_CONTENTS
- ERROR_AV_UPNP_AVT_READ_ERROR
- ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_FORMAT
- ERROR_AV_UPNP_AVT_TRANSPORT_LOCKED
- ERROR_AV_UPNP_AVT_ILLEGAL_MIME
- ERROR_AV_UPNP_AVT_CONTENT_BUSY
- ERROR_AV_UPNP_AVT_RESOURCE_NOT_FOUND
- ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_SPEED
- ERROR_AV_UPNP_AVT_INVALID_INSTANCE_ID
Remarks
This method corresponds to the AVTransport service's Play action.
For more information about the actions in 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 |
| Windows Mobile | Windows Mobile Version 5.0 and later |