IMFHttpDownloadSessionProvider::CreateHttpDownloadSession, méthode (mfidl.h)

Article
08/24/2023

Appelé par Microsoft Media Foundation pour ouvrir les URL HTTP ou HTTPS au lieu d’utiliser l’implémentation par défaut.

Syntaxe

HRESULT CreateHttpDownloadSession(
  [in]  LPCWSTR                wszScheme,
  [out] IMFHttpDownloadSession **ppDownloadSession
);

Paramètres

[in] wszScheme

Nom du protocole pour lequel une imfHttpDownloadSession est demandée. Microsoft Media Foundation spécifie le schéma de protocole de l’URL que l’application a fournie à Media Foundation Source Resolver. Les valeurs valides incluent « http » pour HTTP et « https » pour HTTPS. Les noms de schéma d’URL ne respectent généralement pas la casse.

[out] ppDownloadSession

En cas d’exécution réussie, le paramètre est défini sur un pointeur vers une interface IMFHttpDownloadSession . L’interface retournée est utilisée par Microsoft Media Foundation pour ouvrir une seule URL HTTP ou HTTPS.

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	L’objet IMFHttpDownloadSession a été créé.
E_INVALIDARG	La valeur spécifiée pour le paramètre wszScheme est incorrecte.
E_POINTER	Le paramètre ppDownloadSession n’est pas un pointeur non valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour terminer l’opération.

Notes

La spécification de « https » comme valeur de wszScheme n’implique pas que HTTPS sera utilisé pour une requête particulière, car cela est spécifié par demande dans IMFhttpDownloadSession::CreateRequest.

Configuration requise


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

IMFHttpDownloadSessionProvider

Share via