共用方式為


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
程式庫 Mfplat.lib;Mfplat.dll

另請參閱

IMFHttpDownloadRequest