Interface IFileSourceFilter (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 in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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.]

L’interface IFileSourceFilter est exposée par des filtres sources pour définir le nom de fichier et le type de média du fichier multimédia qu’ils doivent afficher. Il s’agit d’une version abrégée de l’interface COM IPersistFile . Si le fichier a un type qui peut être déterminé par l’algorithme décrit dans Inscription d’un type de fichier personnalisé, le CLSID du filtre source de fichier recommandé est utilisé lorsque le gestionnaire de graphe de filtre tente d’afficher le graphe de filtre.

Si un filtre a besoin du nom d’un fichier à ouvrir, il doit exposer cette interface pour permettre à une application de définir le nom de fichier. Notez qu’il n’existe aucune implémentation de classe de base de cette interface.

Une application qui insère directement des filtres de source de fichier doit interroger cette interface et définir le nom de fichier. Normalement, le gestionnaire de graphe de filtre utilise cette interface lorsqu’une application appelle IGraphBuilder::RenderFile. L’outil Graphedt.exe interroge l’interface IFileSourceFilter et demande un nom de fichier s’il le trouve.

Héritage

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

Méthodes

L’interface IFileSourceFilter a ces méthodes.

IFileSourceFilter::GetCurFile La méthode GetCurFile récupère le nom et le type de média du fichier actif. (IFileSourceFilter.GetCurFile)
IFileSourceFilter::Load La méthode Load entraîne le chargement d’un fichier multimédia par un filtre source.

Configuration requise

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)