IAVTransport::SetAVTransportURI
A version of this page is also available for
4/8/2010
This method specifies the URI of the media resource to be controlled by this AVTransport instance.
Syntax
virtual DWORD SetAVTransportURI(
LPCWSTR pszCurrentURI,
LPCWSTR pszCurrentURIMetaData
) = 0;
Parameters
- pszCurrentURI
[in] URI of the resource to be controlled by this AVTransport instance. Corresponds to the AVTransportURI state variable.
- pszCurrentURIMetaData
[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 AVTransportURIMetaData 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 SetAVTransportURI 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 |