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

Вызывается Microsoft Media Foundation для отправки HTTP- или HTTPS-запроса

Синтаксис

HRESULT BeginSendRequest(
  [in] const BYTE       *pbPayload,
  [in] ULONG            cbPayload,
  [in] IMFAsyncCallback *pCallback,
       IUnknown         *punkState
);

Параметры

[in] pbPayload

Указатель на буфер, содержащий полезные данные сообщения для отправки в запросе. Этот параметр используется для запросов POST. Запросы GET не содержат полезных данных сообщения, поэтому pbPayload имеет значение NULL.

[in] cbPayload

Размер буфера pbPayload в байтах.

[in] pCallback

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

punkState

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

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

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

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

Комментарии

Реализация BeginWrite не требует создания частной копии памяти, на которую указывает pbPayload, так как Microsoft Media Foundation не будет перераспределять, освобождать или записывать данные в буфер, пока асинхронная запись все еще находится в состоянии ожидания.

Требования

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

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

IMFHttpDownloadRequest