Méthode IMFHttpDownloadRequest ::EndReadPayload (mfidl.h)

Article
03/04/2024

Appelé par Microsoft Media Foundation pour terminer l’opération asynchrone démarrée par BeginReadPayload. Une fois cette méthode terminée, les données de charge utile auront été écrites dans la mémoire tampon fournie par Media Foundation lors de l’appel de BeginReadPayload.

Syntaxe

HRESULT EndReadPayload(
  [in]  IMFAsyncResult *pResult,
  [out] QWORD          *pqwOffset,
  [out] ULONG          *pcbRead
);

Paramètres

[in] pResult

Pointeur vers l’interface IMFAsyncResult . Microsoft Media Foundation transmet le même pointeur que son objet de rappel reçu dans la méthode IMFAsyncCallback ::Invoke .

[out] pqwOffset

Décalage du premier octet écrit dans la mémoire tampon, par rapport au corps complet du message de la requête HTTP actuelle. Par exemple, lorsque Media Foundation appelle BeginReadPayload pour la première fois sur une demande IMFHttpDownloadRequest donnée et spécifie une taille de mémoire tampon de 100, le paramètre pqwOffset est défini sur 0. Ensuite, lorsque Media Foundation appelle BeginReadPayload pour la deuxième fois sur le même IMNFHttpDownloadRequest, le paramètre pqwOffset est défini sur 100.

[out] pcbRead

Spécifie le nombre d’octets écrits dans la mémoire tampon fournie par Media Foundation lors de l’appel de BeginReadPayload. Notez que cette valeur doit toujours être égale à la taille de la mémoire tampon spécifiée dans BeginReadPayload, sauf si la demande a échoué ou si la fin du corps du message a été atteinte.

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
S_OK	Les données ont été correctement écrites dans la mémoire tampon fournie dans BeginReadPayload.

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

Voir aussi

IMFHttpDownloadRequest

Partager via