IMFHttpDownloadRequest interface (mfidl.h)

Applications implement this interface to override the default implementation of the HTTP and HTTPS protocols used by Microsoft Media Foundation. Applications provide the IMFHttpDownloadRequest interface to Media Foundation through the CreateRequest method on the IMFHttpDownloadSession interface.

Inheritance

The IMFHttpDownloadRequest interface inherits from the IUnknown interface. IMFHttpDownloadRequest also has these types of members:

Methods

The IMFHttpDownloadRequest interface has these methods.

IMFHttpDownloadRequest::AddHeader Invoked by Microsoft Media Foundation to add a single HTTP header to a HTTP request. Microsoft Media Foundation will invoke this method once for each header that shall be included in the HTTP request, before it invokes the BeginSendRequest method.
IMFHttpDownloadRequest::BeginReadPayload Invoked by Microsoft Media Foundation to receive the message body of the response to a previously sent HTTP or HTTPS request.
IMFHttpDownloadRequest::BeginReceiveResponse Invoked by Microsoft Media Foundation to receive the response, provided by the server, in response to a previously sent HTTP or HTTPS request. Media Foundation invokes this method only after having successfully invoked the EndSendRequest method.
IMFHttpDownloadRequest::BeginSendRequest Invoked by Microsoft Media Foundation to send a HTTP or HTTPS request.
IMFHttpDownloadRequest::Close Invoked by Microsoft Media Foundation to allow IMFHttpDownloadRequest to free any internal resources. It will also cancel the current request if it is still in progress.
IMFHttpDownloadRequest::EndReadPayload Invoked by Microsoft Media Foundation to complete the asynchronous operation started by BeginReadPayload.
IMFHttpDownloadRequest::EndReceiveResponse Invoked by Microsoft Media Foundation to complete the asynchronous operation started by BeginReceiveResponse.
IMFHttpDownloadRequest::EndSendRequest Invoked by Microsoft Media Foundation to complete the asynchronous operation started by BeginSendRequest.
IMFHttpDownloadRequest::GetAtEndOfPayload Invoked by Microsoft Media Foundation to check if it should invoke BeginReadPayload to read data from the message body of the response.
IMFHttpDownloadRequest::GetHttpStatus Invoked by Microsoft Media Foundation to retrieve the HTTP status code that the server specified in its response. Media Foundation invokes this method after a successful call to EndReceiveResponse.
IMFHttpDownloadRequest::GetRangeEndOffset Invoked by Microsoft Media Foundation to retrieve the offset of the last byte in the current response, counted from the start of the resource. This is useful when a request uses the HTTP “Range” header to download only a portion of a resource.
IMFHttpDownloadRequest::GetTimeSeekResult Invoked by Microsoft Media Foundation to retrieve the values of the TimeSeekRange.DLNA.ORG HTTP header, if any, that the server specified in its response.
IMFHttpDownloadRequest::GetTotalLength Invoked by Microsoft Media Foundation to retrieve the total length of the resource that is being downloaded, if known.
IMFHttpDownloadRequest::GetURL Returns the URL that is used for sending the request.
IMFHttpDownloadRequest::HasNullSourceOrigin Invoked by Microsoft Media Foundation to detect the case when a HTTP or HTTPS request has been redirected to a different server of different "origin".
IMFHttpDownloadRequest::QueryHeader Invoked by Microsoft Media Foundation to retrieve the values of specified HTTP headers from the response to a previously sent HTTP or HTTPS request.

Requirements

Requirement	Value
Minimum supported client	Windows 10, version 1703 [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	mfidl.h