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

Voir aussi

Data Flow dans le graphe de filtre

Codes d’erreur et de réussite

IPin Interface