Interface IGraphConfig (strmif.h)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Le Gestionnaire de graphes de filtre s’expose pour prendre en charge la génération de graphiques IGraphConfig dynamiques. Cette interface permet aux applications et aux filtres de reconfigurer le graphe de filtre lorsque le graphe est en cours d’exécution, sans perdre de données du flux.

Le moyen le plus simple de reconstruire dynamiquement le graphe consiste à appeler la méthode IGraphConfig ::Reconnect . Cette méthode gère la plupart des détails de la reconstruction dynamique du graphe. Si jamais vous souhaitez implémenter votre propre technique, IGraphConfig fournit également la méthode IGraphConfig ::Reconfigure . Cette méthode obtient un verrou sur le graphe de filtre, puis appelle une fonction de rappel dans votre application, qui reconfigure le graphe. Avec cette méthode, la majeure partie du travail est déplacée vers votre application. Pour plus d’informations, consultez Génération de graphiques dynamiques.

Pour optimiser le processus d’ajout et de suppression de filtres, le graphe de filtres conserve un cache de filtres. Lors d’un appel à la méthode Reconnect , vous pouvez spécifier que tous les filtres supprimés du graphique sont ajoutés au cache. Vous pouvez également ajouter un filtre au cache directement, si vous savez qu’il est probablement nécessaire, en appelant IGraphConfig ::AddFilterToCache. Les méthodes IGraphBuilder ::Render, IGraphBuilder ::RenderFile et IGraphBuilder ::Connect tentent automatiquement d’utiliser des filtres dans le cache avant d’utiliser d’autres filtres. En outre, dans la méthode Reconnect, vous pouvez spécifier que seuls les filtres mis en cache seront utilisés pour la reconnexion. Notez que les filtres conservés dans le cache ne font pas partie du graphe. Elles sont déconnectées de toutes les broches et sont conservées dans un état arrêté.

Héritage

L’interface IGraphConfig hérite de l’interface IUnknown. IGraphConfig a également les types de membres suivants :

Méthodes

L’interface IGraphConfig possède ces méthodes.

Configuration requise