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