IMFHttpDownloadRequest：：EndReadPayload 方法 (mfidl.h)

由 Microsoft Media Foundation 叫用，以完成 BeginReadPayload 啟動的異步操作。 當此方法順利完成時，承載數據會寫入媒體基礎在叫用 BeginReadPayload 時提供的緩衝區。

語法

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 時，pqwOffset 參數會設定為 100。

[out] pcbRead

指定叫用 BeginReadPayload 時，Media Foundation 提供的緩衝區寫入緩衝區的位元元組數目。 請注意，此值必須一律等於 BeginReadPayload 中指定的緩衝區大小，除非要求失敗，或除非到達訊息本文的結尾。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	已成功將數據寫入 BeginReadPayload 中提供的緩衝區。

規格需求

需求	值
最低支援的用戶端	Windows 10 版本 1703 [僅限傳統型應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	mfidl.h
程式庫	Mfplat.lib;Mfplat.dll

另請參閱

IMFHttpDownloadRequest