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

BeginReadPayload を呼び出して応答のメッセージ本文からデータを読み取る必要があるかどうかをチェックするために、Microsoft Media Foundation によって呼び出されます。 一般的な HTTP 応答の処理中、Media Foundation は BeginReadPayload を 複数回呼び出しますが、 GetAtEndOfPayload によって出力パラメーターが TRUE に設定されると、Media Foundation は BeginReadPayload を 再度呼び出しません。

構文

HRESULT GetAtEndOfPayload(
  [out] BOOL *pfAtEndOfPayload
);

パラメーター

[out] pfAtEndOfPayload

BeginReadPayload の呼び出しで 1 バイト以上のデータを Media Foundation に返すことができる場合は、FALSE に設定します。 返すデータがこれ以上ない場合は TRUE に設定します。

戻り値

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

リターン コード	説明
S_OK	操作は正常に完了しました。
E_POINTER	pfAtEndOfPayload パラメーターは無効なポインターです。

解説

Microsoft Media Foundation は、EndReceiveResponse を正常に呼び出した後にのみ GetAtEndOfPayload を呼び出します。

要件

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

関連項目

IMFHttpDownloadRequest