IMediaFilter ::Run, méthode (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.]
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 |
|---|---|
|
La transition n’est pas terminée. |
|
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 |