Partager via

Interface IAMOpenProgress (strmif.h)

  • Article

[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.

 
IAMOpenProgress ::AbortOperation

La méthode AbortOperation annule l’opération d’ouverture de fichier.
IAMOpenProgress ::QueryProgress

La méthode QueryProgress récupère la progression de l’opération d’ouverture de fichier.

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)