IMFPMediaItem：：GetURL 方法 (mfplay.h)

重要废弃。此 API 可能会从 Windows 的未来版本中删除。应用程序应使用媒体会话进行播放。

获取用于创建媒体项的 URL。

语法

HRESULT GetURL(
  [out] LPWSTR *ppwszURL
);

[out] ppwszURL

接收指向包含 URL 的以 null 结尾的字符串的指针。调用方必须通过调用 CoTaskMemFree 释放字符串。

该方法返回 HRESULT。可能的值包括（但并不限于）下表中的项。

返回代码	说明
S_OK	方法成功。
MF_E_NOTFOUND	没有与此媒体项关联的 URL。
MF_E_SHUTDOWN	调用了 IMFPMediaPlayer：：Shutdown 方法。

当应用程序调用 IMFPMediaPlayer：：CreateMediaItemFromURL 创建媒体项时，此方法适用。如果应用程序调用 IMFPMediaPlayer：：CreateMediaItemFromObject 来创建媒体项，则该媒体项的 GetURL 方法将返回 MF_E_NOTFOUND。