Метод IMFHttpDownloadRequest::EndReadPayload (mfidl.h)

Статья
03/05/2024

Вызывается Microsoft Media Foundation для завершения асинхронной операции, запущенной BeginReadPayload. После успешного завершения этого метода полезные данные будут записаны в буфер, предоставленный Media Foundation при вызове BeginReadPayload.

Синтаксис

HRESULT EndReadPayload(
  [in]  IMFAsyncResult *pResult,
  [out] QWORD          *pqwOffset,
  [out] ULONG          *pcbRead
);

Параметры

[in] pResult

Указатель на интерфейс IMFAsyncResult . Microsoft Media Foundation передает тот же указатель, что и его объект обратного вызова, полученный в методе IMFAsyncCallback::Invoke .

[out] pqwOffset

Смещение первого байта, записанного в буфер, относительно полного текста сообщения текущего HTTP-запроса. Например, если Media Foundation впервые вызывает BeginReadPayload для заданного объекта IMFHttpDownloadRequest и задает размер буфера 100, параметр pqwOffset будет иметь значение 0. Затем, когда Media Foundation вызывает BeginReadPayload во второй раз в том же IMNFHttpDownloadRequest, параметр pqwOffset будет иметь значение 100.

[out] pcbRead

Указывает число байтов, записанных в буфер, предоставленный Media Foundation при вызове BeginReadPayload. Обратите внимание, что это значение всегда должно быть равно размеру буфера, указанному в BeginReadPayload, если запрос не завершился ошибкой или если не достигнут конец текста сообщения.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Данные успешно записаны в буфер, предоставленный в BeginReadPayload.

Требования

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

См. также раздел

IMFHttpDownloadRequest

Поделиться через