Интерфейс IMFHttpDownloadRequest (mfidl.h)

Приложения реализуют этот интерфейс, чтобы переопределить реализацию по умолчанию протоколов HTTP и HTTPS, используемых Microsoft Media Foundation. Приложения предоставляют интерфейс IMFHttpDownloadRequest для Media Foundation с помощью метода CreateRequest в интерфейсе IMFHttpDownloadSession .

Наследование

Интерфейс 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. 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 для получения значений заголовка HTTP TimeSeekRange.DLNA.ORG , если таковые есть, указанного сервером в ответе.
IMFHttpDownloadRequest::GetTotalLength Вызывается Microsoft Media Foundation для получения общей длины загружаемого ресурса, если он известен.
IMFHttpDownloadRequest::GetURL Возвращает URL-адрес, используемый для отправки запроса.
IMFHttpDownloadRequest::HasNullSourceOrigin Вызывается Microsoft Media Foundation для обнаружения случая, когда HTTP- или HTTPS-запрос перенаправляется на другой сервер другого "источника".
IMFHttpDownloadRequest::QueryHeader Вызывается Microsoft Media Foundation для получения значений указанных заголовков HTTP из ответа на ранее отправленный ЗАПРОС HTTP или HTTPS.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10, версия 1703 [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	mfidl.h