Share via


IMFHttpDownloadRequest 介面 (mfidl.h)

應用程式會實作此介面,以覆寫 Microsoft Media Foundation 所使用的 HTTP 和 HTTPS 通訊協定的預設實作。 應用程式會透過IMFHttpDownloadSession 介面上的 CreateRequest 方法,將IMFHttpDownloadRequest 介面提供給媒體基礎。

繼承

IMFHttpDownloadRequest 介面繼承自 IUnknown 介面。 IMFHttpDownloadRequest 也有下列類型的成員:

方法

IMFHttpDownloadRequest 介面具有這些方法。

 
IMFHttpDownloadRequest::AddHeader

由 Microsoft Media Foundation 叫用,將單一 HTTP 標頭新增至 HTTP 要求。 Microsoft Media Foundation 會針對應該包含在 HTTP 要求中的每個標頭叫用這個方法一次,再叫用 BeginSendRequest 方法。
IMFHttpDownloadRequest::BeginReadPayload

由 Microsoft Media Foundation 叫用,以接收先前傳送之 HTTP 或 HTTPS 要求的回應訊息本文。
IMFHttpDownloadRequest::BeginReceiveResponse

由 Microsoft Media Foundation 叫用以接收伺服器所提供的回應,以回應先前傳送的 HTTP 或 HTTPS 要求。 媒體基礎只有在成功叫用 EndSendRequest 方法之後,才會叫用這個方法。
IMFHttpDownloadRequest::BeginSendRequest

由 Microsoft Media Foundation 叫用以傳送 HTTP 或 HTTPS 要求。
IMFHttpDownloadRequest::Close

由 Microsoft Media Foundation 叫用,以允許 IMFHttpDownloadRequest 釋放任何內部資源。 如果目前要求仍在進行中,它也會取消目前的要求。
IMFHttpDownloadRequest::EndReadPayload

由 Microsoft Media Foundation 叫用,以完成 BeginReadPayload 啟動的異步操作。
IMFHttpDownloadRequest::EndReceiveResponse

由 Microsoft Media Foundation 叫用,以完成 BeginReceiveResponse 所啟動的異步操作。
IMFHttpDownloadRequest::EndSendRequest

由 Microsoft Media Foundation 叫用,以完成 BeginSendRequest 啟動的異步操作。
IMFHttpDownloadRequest::GetAtEndOfPayload

由 Microsoft Media Foundation 叫用,以檢查它是否應該叫用 BeginReadPayload,以從回應的訊息本文讀取數據。
IMFHttpDownloadRequest::GetHttpStatus

由 Microsoft Media Foundation 叫用,以擷取伺服器在其回應中指定的 HTTP 狀態代碼。 媒體基礎會在成功呼叫 EndReceiveResponse 之後叫用這個方法。
IMFHttpDownloadRequest::GetRangeEndOffset

由 Microsoft Media Foundation 叫用,以擷取目前回應中最後一個字節的位移,從資源開頭算起。 當要求使用 HTTP “Range” 標頭只下載部分資源時,這會很有用。
IMFHttpDownloadRequest::GetTimeSeekResult

由 Microsoft Media Foundation 叫用,以擷取 TimeSeekRange.DLNA.ORG HTTP 標頭的值,如果有的話,伺服器在其回應中指定的值。
IMFHttpDownloadRequest::GetTotalLength

由 Microsoft Media Foundation 叫用,以擷取所下載資源的總長度,如果已知。
IMFHttpDownloadRequest::GetURL

傳回用來傳送要求的 URL。
IMFHttpDownloadRequest::HasNullSourceOrigin

由 Microsoft Media Foundation 叫用,以偵測 HTTP 或 HTTPS 要求重新導向至不同「來源」的不同伺服器時的情況。
IMFHttpDownloadRequest::QueryHeader

由 Microsoft Media Foundation 叫用,從先前傳送 HTTP 或 HTTPS 要求的回應中擷取指定 HTTP 標頭的值。

規格需求

需求
最低支援的用戶端 Windows 10 版本 1703 [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 mfidl.h