Interface IMediaPosition (control.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 IMediaPosition contient des méthodes permettant de rechercher une position dans un flux.
Cette interface est exposée par le Gestionnaire de graphe de filtres ainsi que par des filtres individuels. Les applications doivent obtenir un pointeur d’interface IMediaPosition à partir du Gestionnaire de graphes de filtre, et non à partir d’un filtre. Le Gestionnaire de graphe de filtre distribue les appels de méthode à tous les filtres du convertisseur. Les filtres de convertisseur propagent les appels amont aux filtres sources. Cette séquence d’événements garantit que tous les flux restent synchronisés.
Si l’un des appels distribués retourne une erreur, le Gestionnaire de graphe de filtres retourne la première valeur d’erreur qu’il a reçue. Dans ce cas, certains appels distribués ont peut-être réussi. Toutefois, le graphique de filtre ne retourne pas E_NOTIMPL , sauf si tous les appels distribués retournent E_NOTIMPL. Si au moins un filtre du graphe implémente la méthode, le Gestionnaire de graphes de filtre ne retourne pas E_NOTIMPL.
Héritage
L’interface IMediaPosition hérite de l’interface IDispatch. IMediaPosition a également les types de membres suivants :
Méthodes
L’interface IMediaPosition a ces méthodes.
| IMediaPosition ::CanSeekBackward La méthode CanSeekBackward détermine si le graphique de filtre peut rechercher vers l’arrière dans le flux. |
| IMediaPosition ::CanSeekForward La méthode CanSeekForward détermine si le graphique de filtre peut rechercher vers l’avant dans le flux. |
| IMediaPosition ::get_CurrentPosition La méthode get_CurrentPosition récupère la position actuelle, par rapport à la durée totale du flux. |
| IMediaPosition ::get_Duration La méthode get_Duration récupère la durée du flux. |
| IMediaPosition ::get_PrerollTime La méthode get_PrerollTime récupère la quantité de données qui seront mises en file d’attente avant la position de départ. |
| IMediaPosition ::get_Rate La méthode get_Rate récupère le taux de lecture. |
| IMediaPosition ::get_StopTime La méthode get_StopTime récupère l’heure à laquelle la lecture s’arrête, par rapport à la durée du flux. |
| IMediaPosition ::p ut_CurrentPosition La méthode put_CurrentPosition définit la position actuelle, par rapport à la durée totale du flux. |
| IMediaPosition ::p ut_PrerollTime La méthode put_PrerollTime définit la quantité de données qui seront mises en file d’attente avant la position de départ. |
| IMediaPosition ::p ut_Rate La méthode put_Rate définit la vitesse de lecture. |
| IMediaPosition ::p ut_StopTime La méthode put_StopTime définit l’heure à laquelle la lecture s’arrêtera, par rapport à la durée du flux. |
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 | control.h (include Dshow.h) |