Partager via


Interface IFileSinkFilter2 (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.]

L’interface IFileSinkFilter2 étend l’interface IFileSinkFilter. Les filtres qui écrivent des flux multimédias dans un fichier implémentent cette interface. Un filtre récepteur de fichiers dans un graphique de filtre de capture vidéo, pour instance, enregistre la sortie du filtre de compression vidéo dans un fichier. En règle générale, l’application exécutant ce graphe de filtre doit permettre à l’utilisateur d’entrer le nom du fichier dans lequel enregistrer les données. Cette interface vous permet de communiquer ces informations.

IFileSinkFilter2 ajoute l’option pour déterminer si le fichier qu’il écrit doit détruire un fichier existant du même nom. Dans le cas de la capture vidéo, ne détruisez pas un fichier que vous avez déjà créé, car la préaffectation de l’espace de fichier prend un temps précieux. Par défaut, le nouveau fichier ne détruit pas l’ancien. Sinon, détruisez le fichier d’origine pour vous assurer que le fichier que vous créez ne contient pas de mémoire.

Héritage

L’interface IFileSinkFilter2 hérite de IFileSinkFilter. IFileSinkFilter2 a également les types de membres suivants :

Méthodes

L’interface IFileSinkFilter2 comporte ces méthodes.

 
IFileSinkFilter2 ::GetMode

La méthode GetMode récupère si l’enregistreur de fichiers détruit le fichier lorsqu’il en crée un.
IFileSinkFilter2 ::SetMode

La méthode SetMode détermine si l’enregistreur de fichiers détruit le fichier lorsqu’il en crée un.

Configuration requise

Condition requise Valeur
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)

Voir aussi

IFileSinkFilter

Interfaces