IMFHttpDownloadSessionProvider::CreateHttpDownloadSession, méthode (mfidl.h)
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 |
|---|---|
|
L’objet IMFHttpDownloadSession a été créé. |
|
La valeur spécifiée pour le paramètre wszScheme est incorrecte. |
|
Le paramètre ppDownloadSession n’est pas un pointeur non valide. |
|
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 |