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
);

parameters

[out] pb

指向接收数据的缓冲区的指针。

[in] cb

指定 pb 缓冲区的大小(以字节为单位)。

[in] pCallback

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

punkState

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

返回值

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

返回代码 说明
S_OK
已成功启动异步操作。

注解

Microsoft Media Foundation 从不调用 BeginReadPayload ,而之前对 BeginReadPayload 的调用尚未完成。

要求

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

另请参阅

IMFHttpDownloadRequest