Share via

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

指向由 Microsoft Media Foundation 实现的回调对象的 IMFAsyncCallback 接口的指针。

punkState

指向状态对象的 IUnknown 接口的指针，该接口由 Microsoft Media Foundation 定义。 此参数可以为 NULL。

返回值

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码 说明
S_OK
 已成功启动异步操作。
E_OUTOFMEMORY
 内存不足，无法完成操作。

注解

BeginWrite 的实现不需要创建 pbPayload 指向的内存的专用副本，因为当异步写入仍处于挂起状态时，Microsoft Media Foundation 将不会重新分配、释放或写入缓冲区。

要求

要求 值
最低受支持的客户端 Windows 10版本 1703 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 mfidl.h
Library Mfplat.lib;Mfplat.dll

另请参阅

IMFHttpDownloadRequest