IAVTransport::SetPlayMode (Windows Embedded CE 6.0)
1/6/2010
This method sets the current play mode for this AVTransport instance.
Syntax
virtual DWORD SetPlayMode(
LPCWSTR pszNewPlayMode
) = 0;
Parameters
- pszNewPlayMode
[in] Play mode, like normal, shuffle, repeat all, and so on. Contains one of the PlayMode constants. Corresponds to the CurrentPlayMode 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_TRANSPORT_LOCKED
- ERROR_AV_UPNP_AVT_UNSUPPORTED_PLAY_MODE
- ERROR_AV_UPNP_AVT_INVALID_INSTANCE_ID
Remarks
This method corresponds to the AVTransport service's SetPlayMode action.
The AVTransport service does not require that this method be implemented. The IAVTransportImpl class therefore overrides this method to return ERROR_AV_UPNP_INVALID_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 |