Partager via


Méthode COutputQueue.NewSegment

[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 NewSegment méthode remet un nouveau segment à la broche d’entrée.

Syntaxe

HRESULT NewSegment(
   REFERENCE_TIME tStart,
   REFERENCE_TIME tStop,
   double         dRate
);

Paramètres

tStart

Position du média de départ du segment, en unités de 100 nanosecondes.

tStop

Position du média de fin du segment, en unités de 100 nanosecondes.

dRate

Taux auquel ce segment doit être traité, en pourcentage du taux d’origine.

Valeur renvoyée

Retourne une valeur HRESULT .

Notes

Si l’objet utilise un thread, il met en file d’attente les éléments suivants, dans l’ordre :

  • Message de contrôle NEW_SEGMENT.
  • Données de segment.

Le message NEW_SEGMENT avertit le thread que l’élément suivant de la file d’attente contiendra des données de segment. Les données de segment sont regroupées dans une structure, déclarée comme suit :

struct NewSegmentPacket {
    REFERENCE_TIME tStart;
    REFERENCE_TIME tStop;
    double dRate;
}; 

Le thread appelle la méthode IPin::NewSegment sur la broche d’entrée, à l’aide des données fournies dans la structure.

Si l’objet n’utilise pas de thread, il appelle la méthode COutputQueue::SendAnyway pour remettre les exemples en attente. Ensuite, il appelle IPin::NewSegment sur la broche d’entrée.

Configuration requise

Condition requise Valeur
En-tête
Outputq.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

COutputQueue, classe