Interface IMFHttpDownloadRequest (mfidl.h)

Les applications implémentent cette interface pour remplacer l’implémentation par défaut des protocoles HTTP et HTTPS utilisés par Microsoft Media Foundation. Les applications fournissent l’interface IMFHttpDownloadRequest à Media Foundation via la méthode CreateRequest sur l’interface IMFHttpDownloadSession .

Héritage

L’interface IMFHttpDownloadRequest hérite de l’interface IUnknown. IMFHttpDownloadRequest a également les types de membres suivants :

Méthodes

L’interface IMFHttpDownloadRequest utilise ces méthodes.

IMFHttpDownloadRequest ::AddHeader Appelé par Microsoft Media Foundation pour ajouter un en-tête HTTP unique à une requête HTTP. Microsoft Media Foundation appelle cette méthode une fois pour chaque en-tête qui doit être inclus dans la requête HTTP, avant d’appeler la méthode BeginSendRequest.
IMFHttpDownloadRequest ::BeginReadPayload Appelé par Microsoft Media Foundation pour recevoir le corps du message de la réponse à une requête HTTP ou HTTPS précédemment envoyée.
IMFHttpDownloadRequest ::BeginReceiveResponse Appelé par Microsoft Media Foundation pour recevoir la réponse, fournie par le serveur, en réponse à une requête HTTP ou HTTPS précédemment envoyée. Media Foundation appelle cette méthode uniquement après avoir appelé avec succès la méthode EndSendRequest.
IMFHttpDownloadRequest ::BeginSendRequest Appelé par Microsoft Media Foundation pour envoyer une requête HTTP ou HTTPS.
IMFHttpDownloadRequest ::Close Appelé par Microsoft Media Foundation pour permettre à IMFHttpDownloadRequest de libérer toutes les ressources internes. Elle annule également la demande actuelle si elle est toujours en cours.
IMFHttpDownloadRequest ::EndReadPayload Appelé par Microsoft Media Foundation pour terminer l’opération asynchrone démarrée par BeginReadPayload.
IMFHttpDownloadRequest ::EndReceiveResponse Appelé par Microsoft Media Foundation pour terminer l’opération asynchrone démarrée par BeginReceiveResponse.
IMFHttpDownloadRequest ::EndSendRequest Appelé par Microsoft Media Foundation pour terminer l’opération asynchrone démarrée par BeginSendRequest.
IMFHttpDownloadRequest ::GetAtEndOfPayload Appelé par Microsoft Media Foundation pour case activée s’il doit appeler BeginReadPayload pour lire les données du corps du message de la réponse.
IMFHttpDownloadRequest ::GetHttpStatus Appelé par Microsoft Media Foundation pour récupérer le code HTTP status spécifié par le serveur dans sa réponse. Media Foundation appelle cette méthode après un appel réussi à EndReceiveResponse.
IMFHttpDownloadRequest ::GetRangeEndOffset Appelé par Microsoft Media Foundation pour récupérer le décalage du dernier octet dans la réponse actuelle, compté à partir du début de la ressource. Cela est utile lorsqu’une requête utilise l’en-tête HTTP « Range » pour télécharger uniquement une partie d’une ressource.
IMFHttpDownloadRequest ::GetTimeSeekResult Appelé par Microsoft Media Foundation pour récupérer les valeurs de l’en-tête HTTP TimeSeekRange.DLNA.ORG, le cas échéant, que le serveur a spécifié dans sa réponse.
IMFHttpDownloadRequest ::GetTotalLength 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.
IMFHttpDownloadRequest ::GetURL Retourne l’URL utilisée pour l’envoi de la demande.
IMFHttpDownloadRequest ::HasNullSourceOrigin Appelé par Microsoft Media Foundation pour détecter le cas où une requête HTTP ou HTTPS a été redirigée vers un autre serveur d’origine différente.
IMFHttpDownloadRequest ::QueryHeader Appelé par Microsoft Media Foundation pour récupérer les valeurs des en-têtes HTTP spécifiés à partir de la réponse à une requête HTTP ou HTTPS précédemment envoyée.

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