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

パラメーター

[out] pb

データを受信するバッファーへのポインター。

[in] cb

pb バッファーのサイズをバイト単位で指定します。

[in] pCallback

Microsoft Media Foundation によって実装されるコールバック オブジェクトの IMFAsyncCallback インターフェイスへのポインター。

punkState

Microsoft Media Foundation によって定義された状態オブジェクトの IUnknown インターフェイスへのポインター。 このパラメーターは、NULL でもかまいません。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード	説明
S_OK	非同期操作が正常に開始されました。

解説

Microsoft Media Foundation は BeginReadPayload を 呼び出しませんが、 BeginReadPayload の以前の呼び出しはまだ完了していません。

要件

サポートされている最小のクライアント	Windows 10バージョン 1703 [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	mfidl.h
Library	Mfplat.lib;Mfplat.dll

関連項目

IMFHttpDownloadRequest