IAVTransport::SetNextAVTransportURI
A version of this page is also available for
4/8/2010
This method specifies the URI of the next media resource to be controlled by this AVTransport instance.
Syntax
virtual DWORD SetNextAVTransportURI(
LPCWSTR pszNextURI,
LPCWSTR pszNextURIMetaData
) = 0;
Parameters
- pszNextURI
[in] URI of the next resource to be controlled by this AVTransport instance. Corresponds to the NextAVTransportURI state variable.
- pszNextURIMetaData
[in] Optional; can be NULL. Can contain a DIDL-Lite XML fragment that should be stored by this method's implementation in the AVTransportURIMetaData state variable and returned by IAVTransport::GetMediaInfo. If NULL, no media metadata should be stored or returned. Corresponds to the NextAVTransportURIMetaData state variable.
Return Value
Custom implementations can return appropriate error codes. If this method succeeds, it should return SUCCESS_AV. Otherwise, it 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 one of the following errors documented for this action in the AVTransport DCP documentation:
- ERROR_AV_UPNP_AVT_ILLEGAL_MIME
- ERROR_AV_UPNP_AVT_CONTENT_BUSY
- ERROR_AV_UPNP_AVT_RESOURCE_NOT_FOUND
- ERROR_AV_UPNP_AVT_INVALID_INSTANCE_ID
Remarks
This method corresponds to the AVTransport service's SetNextAVTransportURI action.
The AVTransport service does not require that this method be implemented. Therefore, the IAVTransportImpl class 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 |
| Windows Mobile | Windows Mobile Version 5.0 and later |