IMFHttpDownloadRequest::GetTotalLength-Methode (mfidl.h)

Wird von Microsoft Media Foundation aufgerufen, um die Gesamtlänge der heruntergeladenen Ressource abzurufen, sofern bekannt.

Syntax

HRESULT GetTotalLength(
  [out] QWORD *pqwTotalLength
);

Parameter

[out] pqwTotalLength

Die Gesamtlänge der heruntergeladenen Ressource (in Bytes), sofern bekannt. Wenn nicht bekannt, legen Sie auf MAX_ULONG (0xFFFFFFFFFFFFFFFF) fest.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
Der Vorgang wurde erfolgreich abgeschlossen.
E_POINTER
Der pqwTotalLength-Parameter ist ein ungültiger Zeiger.

Hinweise

Microsoft Media Foundation ruft GetTotalLength erst nach dem erfolgreichen Aufruf von EndReceiveResponse auf. Die Gesamtlänge der Ressource kann größer sein als die Vom Server in der aktuellen Antwort zurückgegebene Datenmenge. Wenn die Anforderung beispielsweise den HTTP-Header "Range" enthält, können die in der Antwort zurückgegebenen Daten kleiner als die Gesamtlänge der Ressource sein. Die GetRangeEndOffset-Methode kann verwendet werden, um zu berechnen, wie viele Daten in der aktuellen Antwort zurückgegeben werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1703 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfplat.lib; Mfplat.dll

Weitere Informationen

IMFHttpDownloadRequest