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

  • [アーティクル]

Microsoft Media Foundation によって呼び出され、ダウンロードされるリソースの合計の長さ (既知の場合) を取得します。

構文

HRESULT GetTotalLength(
  [out] QWORD *pqwTotalLength
);

パラメーター

[out] pqwTotalLength

ダウンロードされるリソースの合計長 (バイト単位)。 不明な場合は、 MAX_ULONG (0xFFFFFFFFFFFFFFFF) に設定します。

戻り値

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

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

注釈

Microsoft Media Foundation は、EndReceiveResponse を正常に呼び出した後にのみ GetTotalLength を呼び出します。 リソースの合計長は、現在の応答でサーバーによって返されるデータの量よりも大きくなる可能性があります。 たとえば、要求に HTTP "Range" ヘッダーが含まれている場合、応答で返されるデータはリソースの全長よりも短い場合があります。 GetRangeEndOffset メソッドを使用すると、現在の応答で返されるデータの量を計算できます。

要件

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

こちらもご覧ください

IMFHttpDownloadRequest