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 將用於特定要求，因為該 HTTPS 是以 IMFHTTPDownloadSession：：CreateRequest中的個別要求為基礎指定。