IMFHttpDownloadRequest 接口 (mfidl.h)

应用程序实现此接口以覆盖 Microsoft Media Foundation 使用的 HTTP 和 HTTPS 协议的默认实现。 应用程序通过 IMFHttpDownloadSession 接口上的 CreateRequest 方法，向 Media Foundation 提供 IMFHttpDownloadRequest 接口。

继承

IMFHttpDownloadRequest 接口继承自 IUnknown 接口。 IMFHttpDownloadRequest 也有以下类型的成员：

方法

IMFHttpDownloadRequest 接口具有这些方法。

IMFHttpDownloadRequest：：AddHeader 由 Microsoft Media Foundation 调用，将单个 HTTP 标头添加到 HTTP 请求。 在调用 BeginSendRequest 方法之前，Microsoft Media Foundation 将对应包含在 HTTP 请求中的每个标头调用此方法一次。
IMFHttpDownloadRequest：：BeginReadPayload 由 Microsoft Media Foundation 调用以接收对以前发送的 HTTP 或 HTTPS 请求的响应的消息正文。
IMFHttpDownloadRequest：：BeginReceiveResponse 由 Microsoft Media Foundation 调用以接收服务器提供的响应，以响应以前发送的 HTTP 或 HTTPS 请求。 Media Foundation 仅在成功调用 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 状态代码。 Media Foundation 在成功调用 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