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。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
已成功启动异步操作。 |
|
内存不足,无法完成操作。 |
注解
BeginWrite 的实现不需要创建 pbPayload 指向的内存的专用副本,因为当异步写入仍处于挂起状态时,Microsoft Media Foundation 将不会重新分配、释放或写入缓冲区。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10版本 1703 [仅限桌面应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | mfidl.h |
Library | Mfplat.lib;Mfplat.dll |