Méthode IPin ::NewSegment (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 dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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 NewSegment méthode avertit l’épingle que les exemples multimédias reçus après cet appel sont regroupés sous forme de segment, avec une heure de début, une heure d’arrêt et une fréquence communes.
Les applications ne doivent pas appeler cette méthode. Cette méthode est appelée par d’autres filtres.
Syntaxe
HRESULT NewSegment(
REFERENCE_TIME tStart,
REFERENCE_TIME tStop,
double dRate
);
Paramètres
tStart
Heure de début du segment, par rapport à la source d’origine, en unités de 100 nanosecondes.
tStop
Heure de fin du segment, par rapport à la source d’origine, en unités de 100 nanosecondes.
dRate
Taux auquel ce segment doit être traité, en pourcentage du taux d’origine.
Valeur retournée
Retourne S_OK en cas de réussite ou une valeur HRESULT indiquant la cause de l’erreur.
Remarques
Un filtre source (ou filtre d’analyseur) appelle cette méthode au début de chaque nouveau flux et après chaque opération de recherche. Il appelle la méthode sur la broche d’entrée du filtre en aval, après avoir remis le lot de données précédent et avant d’appeler IMemInputPin ::Receive avec de nouvelles données. Le filtre en aval propage l’appel NewSegment en aval.
Les filtres peuvent utiliser les informations de segment pour traiter des exemples. Par exemple, avec certains formats, il est impossible de reconstruire une image delta sans l’image clé suivante. Par conséquent, si l’heure d’arrêt se produit sur une image delta, le filtre source doit envoyer des images supplémentaires. Le filtre de décodeur détermine la trame finale en fonction des informations de segment. Le débit de segment est utilisé pour afficher des sources de données continues, telles que des données audio. Par exemple, le convertisseur audio utilise le taux d’échantillonnage et le taux de segment pour restituer correctement les données audio.
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 |