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

Вызывается Microsoft Media Foundation для получения текста сообщения ответа на ранее отправленный ЗАПРОС HTTP или HTTPS. Media Foundation вызывает этот метод только после успешного вызова метода EndReceiveResponse . Так как размер текста сообщения может быть большим или неизвестным, Media Foundation может вызывать этот метод несколько раз, чтобы получить текст сообщения поэтапно.

Синтаксис

HRESULT BeginReadPayload(
  [out] BYTE             *pb,
  [in]  ULONG            cb,
  [in]  IMFAsyncCallback *pCallback,
        IUnknown         *punkState
);

Параметры

[out] pb

Указатель на буфер, который получает данные.

[in] cb

Указывает размер буфера pb в байтах.

[in] pCallback

Указатель на интерфейс IMFAsyncCallback объекта обратного вызова, который реализуется Microsoft Media Foundation.

punkState

Указатель на интерфейс IUnknown объекта состояния, определенного Microsoft Media Foundation. Этот параметр может принимать значение NULL.

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

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

Код возврата	Описание
S_OK	Асинхронная операция успешно запущена.

Комментарии

Microsoft Media Foundation никогда не вызывает BeginReadPayload , пока предыдущий вызов BeginReadPayload еще не завершен.

Требования

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

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

IMFHttpDownloadRequest