IMediaFilter ::Run, méthode (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.]

La Run méthode exécute le filtre.

Syntaxe

HRESULT Run(
  REFERENCE_TIME tStart
);

Paramètres

tStart

Heure de référence correspondant à l’heure de flux 0.

Valeur retournée

Retourne une valeur HRESULT . Les valeurs possibles incluent celles indiquées dans le tableau suivant.

Code de retour Description
S_FALSE
 La transition n’est pas terminée.
S_OK
 Réussite. La transition est terminée.

Remarques

Lorsqu’un filtre est en cours d’exécution, il peut recevoir, traiter et remettre des exemples. Les filtres sources génèrent de nouveaux exemples et les filtres de renderer les affichent.

La transition d’état peut être asynchrone. Si la méthode retourne avant la fin de la transition, la valeur de retour est S_FALSE.

Stream heure est calculée comme l’heure de référence actuelle moins tStart. Pour calculer le moment où un exemple de média doit être rendu, le convertisseur compare l’horodatage à l’heure actuelle du flux. Par conséquent, un exemple de média avec un horodatage de zéro doit être rendu à l’heure tStart. Pour plus d’informations, consultez Heure et horloges dans DirectShow.

Lorsqu’une application appelle la méthode IMediaControl ::Run , le Gestionnaire de graphes de filtre appelle IMediaFilter::Run sur chaque filtre. Il définit la valeur de tStart légèrement à l’avenir, pour tenir compte de la latence du graphique.

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)
Bibliothèque Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IMediaFilter, interface