Share via


IAVTransport::SetAVTransportURI (Windows Embedded CE 6.0)

1/6/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

See Also

Reference

IAVTransport
UPnPAVError