Méthode IMFMediaEngine ::Load (mfmediaengine.h)
Charge la source multimédia actuelle.
Syntaxe
HRESULT Load();
Valeur retournée
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
L’objectif main de cette méthode est de recharger une liste d’éléments sources après la mise à jour de la liste. Pour plus d’informations, consultez SetSourceElements. Sinon, l’appel de cette méthode n’est généralement pas obligatoire. Pour charger une nouvelle source multimédia, appelez IMFMediaEngine ::SetSource ou IMFMediaEngine ::SetSourceElements.
La méthode Load appelle explicitement l’algorithme de chargement des ressources multimédias du moteur multimédia. Avant d’appeler cette méthode, vous devez définir la ressource multimédia en appelant IMFMediaEngine ::SetSource ou IMFMediaEngine ::SetSourceElements.
Cette méthode se termine de manière asynchrone. Lorsque l’opération de chargement démarre, le moteur multimédia envoie un événement MF_MEDIA_ENGINE_EVENT_LOADSTART . Si aucune erreur ne se produit pendant l’opération de chargement , plusieurs autres événements sont générés, notamment les suivants.
- MF_MEDIA_ENGINE_EVENT_LOADEDMETADATA
- MF_MEDIA_ENGINE_EVENT_LOADEDDATA
- MF_MEDIA_ENGINE_EVENT_CANPLAY
- MF_MEDIA_ENGINE_EVENT_CANPLAYTHROUGH
Pour plus d’informations sur la gestion des événements dans le moteur multimédia, consultez IMFMediaEngineNotify.
Cette méthode correspond à la méthode de chargement de l’interface HTMLMediaElement dans HTML5.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | mfmediaengine.h |