IMFHttpDownloadSessionProvider：：CreateHttpDownloadSession 方法 (mfidl.h)

由 Microsoft Media Foundation 调用以打开 HTTP 或 HTTPS URL，而不是使用默认实现。

语法

HRESULT CreateHttpDownloadSession(
  [in]  LPCWSTR                wszScheme,
  [out] IMFHttpDownloadSession **ppDownloadSession
);

[in] wszScheme

为其请求 IMFHttpDownloadSession 的协议的名称。 Microsoft Media Foundation 指定应用程序提供的媒体基础源解析程序的 URL 的协议方案。有效值包括 HTTP 的“http”和 HTTPS 的“https”。 URL 方案名称通常不区分大小写。

[out] ppDownloadSession

成功执行后，参数设置为指向 IMFHttpDownloadSession 接口的指针。 Microsoft Media Foundation 使用返回的接口打开单个 HTTP 或 HTTPS URL。

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

返回代码	说明
S_OK	已成功创建 IMFHttpDownloadSession 对象。
E_INVALIDARG	为 wszScheme 参数指定的值不正确。
E_POINTER	ppDownloadSession 参数是无效的指针。
E_OUTOFMEMORY	内存不足，无法完成操作。

将“https”指定为 wszScheme 的值并不意味着 HTTPS 将用于特定请求，因为该请求是在 IMFhttpDownloadSession：：CreateRequest 中基于每个请求指定的。