Guide pratique pour lire des fichiers multimédias avec Media Foundation
Ce tutoriel montre comment lire des fichiers multimédias à l’aide de l’objet Session multimédia .
Prérequis
Avant de lire cette rubrique, vous devez vous familiariser avec les concepts suivants de Media Foundation :
- Session multimédia
- Programme de résolution source
- Topologies
- Générateurs d’événements multimédias
- Descripteurs de présentation
Notes
Cette rubrique ne décrit pas comment lire les fichiers protégés par la gestion des droits numériques (DRM). Pour plus d’informations sur la gestion des droits numériques dans Microsoft Media Foundation, consultez Guide pratique pour lire des fichiers multimédias protégés.
Vue d’ensemble
Les objets suivants sont utilisés pour lire un fichier multimédia avec la session multimédia :
- Une source multimédia est un objet qui analyse un fichier multimédia ou une autre source de données multimédias. La source multimédia crée des objets stream pour chaque flux audio ou vidéo dans le fichier. Les décodeurs convertissent les données multimédias encodées en vidéos et audio non compressées.
- Source Resolver crée une source multimédia à partir d’une URL.
- Le convertisseur vidéo amélioré (EVR) affiche la vidéo à l’écran.
- Le convertisseur audio de streaming (SAR) restitue l’audio sur un haut-parleur ou un autre périphérique de sortie audio.
- Une topologie définit le flux de données de la source multimédia vers l’EVR et le SAR.
- La session multimédia contrôle le flux de données et envoie status événements à l’application. Le diagramme suivant illustre ce processus.
Voici un aperçu général des étapes nécessaires pour lire un fichier multimédia à l’aide de la session multimédia :
Appelez la fonction MFStartup pour initialiser la plateforme Media Foundation.
Appelez MFCreateMediaSession pour créer une instance de la session multimédia.
Utilisez le programme de résolution source pour créer une source multimédia. Pour plus d’informations, consultez Utilisation du programme de résolution de source.
Créez une topologie qui connecte la source multimédia à l’EVR et au SAR. Dans cette étape, l’application crée une topologie partielle qui n’inclut pas les décodeurs. Pour plus d’informations, consultez Création de topologies de lecture.
Appelez IMFMediaSession::SetTopology pour définir la topologie sur la session multimédia.
Utilisez l’interface IMFMediaEventGenerator pour obtenir des événements à partir de la session multimédia.
Appelez IMFMediaSession::Start pour démarrer la lecture. Une fois la lecture démarrée, vous pouvez la suspendre en appelant IMFMediaSession::P ause, ou l’arrêter en appelant IMFMediaSession::Stop.
À la sortie de l’application, libèrez les ressources :
- Appelez IMFMediaSession::Fermer pour fermer la session multimédia. Cette méthode est asynchrone. Une fois terminée, la session multimédia envoie un événement MESessionClosed . Ensuite, il est prudent d’effectuer les étapes restantes.
- Appelez IMFMediaSource::Shutdown pour arrêter la source du média.
- Appelez IMFMediaSession::Shutdown pour arrêter la session multimédia.
- Appelez MFShutdown pour arrêter la plateforme Media Foundation.
Les sections suivantes présentent un exemple de code complet :
- Étape 1 : Déclarer la classe CPlayer
- Étape 2 : Créer l’objet CPlayer
- Étape 3 : Ouvrir un fichier multimédia
- Étape 4 : Créer la session multimédia
- Étape 5 : Gérer les événements de session multimédia
- Étape 6 : Contrôler la lecture
- Étape 7 : Arrêter la session multimédia
- Exemple de lecture de session multimédia
Rubriques connexes