Интерфейс 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 |