IMFHttpDownloadRequest::GetTotalLength method (mfidl.h)
Invoked by Microsoft Media Foundation to retrieve the total length of the resource that is being downloaded, if known.
Syntax
HRESULT GetTotalLength(
[out] QWORD *pqwTotalLength
);
Parameters
[out] pqwTotalLength
The total length, in bytes, of the resource being downloaded, if known. If not known, set to MAX_ULONG (0xFFFFFFFFFFFFFFFF).
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
Successfully completed the operation. |
|
The pqwTotalLength parameter is an invalid pointer. |
Remarks
Microsoft Media Foundation invokes GetTotalLength only after having successfully invoked EndReceiveResponse. The total length of the resource may be larger than the amount of data returned by the server in the current response. For example, if the request included the HTTP “Range” header, the data returned in the response may be less than total length of the resource. The GetRangeEndOffset method can be used to calculate how much data is returned in the current response.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10, version 1703 [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | mfidl.h |
| Library | Mfplat.lib; Mfplat.dll |