IMFHttpDownloadRequest::EndReadPayload メソッド (mfidl.h)

BeginReadPayload によって開始された非同期操作を完了するために、Microsoft Media Foundation によって呼び出されます。 このメソッドが正常に完了すると、ペイロード データは 、BeginReadPayload の呼び出し時に Media Foundation が指定したバッファーに書き込まれます。

構文

HRESULT EndReadPayload(
  [in]  IMFAsyncResult *pResult,
  [out] QWORD          *pqwOffset,
  [out] ULONG          *pcbRead
);

パラメーター

[in] pResult

IMFAsyncResult インターフェイスへのポインター。 Microsoft Media Foundation は、そのコールバック オブジェクトが IMFAsyncCallback::Invoke メソッドで受け取ったのと同じポインターを渡します。

[out] pqwOffset

現在の HTTP 要求の完全なメッセージ本文を基準にしてバッファーに書き込まれた最初のバイトのオフセット。 たとえば、Media Foundation が特定の IMFHttpDownloadRequest で初めて BeginReadPayload を呼び出し、バッファー サイズを 100 に指定すると、pqwOffset パラメーターは 0 に設定されます。 次に、Media Foundation が同じ IMNFHttpDownloadRequest で BeginReadPayload を 2 回目に呼び出すと、pqwOffset パラメーターは 100 に設定されます。

[out] pcbRead

BeginReadPayload の呼び出し時に Media Foundation が指定したバッファーに書き込まれるバイト数を指定します。 この値は、要求が失敗しない限り、またはメッセージ本文の末尾に達していない限り、 BeginReadPayload で指定されたバッファーのサイズと常に等しい必要があります。

戻り値

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

リターン コード	説明
S_OK	BeginReadPayload で提供されているバッファーにデータを正常に書き込みます。

要件

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

こちらもご覧ください

IMFHttpDownloadRequest