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 |