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

Voir aussi

IMFMediaEngine