Méthode IMFHttpDownloadRequest ::GetTotalLength (mfidl.h)
Appelé par Microsoft Media Foundation pour récupérer la longueur totale de la ressource en cours de téléchargement, si elle est connue.
Syntaxe
HRESULT GetTotalLength(
[out] QWORD *pqwTotalLength
);
Paramètres
[out] pqwTotalLength
Longueur totale, en octets, de la ressource en cours de téléchargement, si elle est connue. S’il n’est pas connu, définissez sur MAX_ULONG (0xFFFFFFFFFFFFFFFF).
Valeur retournée
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
L’opération s’est terminée correctement. |
|
Le paramètre pqwTotalLength est un pointeur non valide. |
Remarques
Microsoft Media Foundation appelle GetTotalLength uniquement après avoir correctement appelé EndReceiveResponse. La longueur totale de la ressource peut être supérieure à la quantité de données retournée par le serveur dans la réponse actuelle. Par exemple, si la requête incluait l’en-tête HTTP « Range », les données retournées dans la réponse peuvent être inférieures à la longueur totale de la ressource. La méthode GetRangeEndOffset peut être utilisée pour calculer la quantité de données retournées dans la réponse actuelle.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10, version 1703 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | mfidl.h |
| Bibliothèque | Mfplat.lib ; Mfplat.dll |