通过

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