Interface IAMOpenProgress (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 IAMOpenProgress signale la progression d’une opération d’ouverture de fichier et permet à l’application d’annuler l’opération.

Les filtres qui ouvrent des fichiers sur un réseau peuvent exposer cette interface. Une application peut l’utiliser pour interroger la progression du téléchargement ou pour annuler le téléchargement. Si le réseau n’est pas réactif, une méthode telle que IGraphBuilder ::RenderFile peut se bloquer pendant une période indéterminée. Pour empêcher votre application de se bloquer, créez un thread de travail qui utilise IAMOpenProgress pour surveiller la progression. Le thread de travail peut annuler l’opération si un délai d’expiration prédéfini se produit ou en réponse à une commande de l’utilisateur.

Le filtre Source de fichier (URL) prend en charge cette interface.

Héritage

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

Méthodes

L’interface IAMOpenProgress utilise ces méthodes.

Configuration requise