Méthode CBaseRenderer.GetSampleTimes

  • Article

[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 GetSampleTimes méthode récupère les horodatages d’un exemple.

Syntaxe

virtual HRESULT GetSampleTimes(
   IMediaSample   *pMediaSample,
   REFERENCE_TIME *pStartTime,
   REFERENCE_TIME *pEndTime
);

Paramètres

pMediaSample

Pointeur vers l’interface IMediaSample de l’exemple.

pStartTime

Pointeur vers une variable qui reçoit l’heure de début.

pEndTime

Pointeur vers une variable qui reçoit l’heure de fin.

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles incluent celles indiquées dans le tableau suivant.

Code de retour Description
S_OK
 L’exemple doit être rendu immédiatement.
S_FALSE
 L’exemple doit être planifié pour le rendu, en fonction des horodatages.
E_FAIL
 N’affichez pas cet exemple.
VFW_E_START_TIME_AFTER_END
 Horodatage incorrect : l’heure de fin est antérieure à l’heure de début.

Notes

Le filtre appelle cette méthode pour déterminer comment il doit gérer un exemple. Si la valeur de retour est S_OK, le filtre restitue immédiatement l’exemple. Si la valeur de retour est S_FALSE, le filtre planifie le rendu de l’exemple en fonction des horodatages. Si la valeur de retour est un code d’erreur, le filtre rejette l’exemple.

Cette méthode retourne S_OK si l’exemple n’a pas d’horodatage ou si le filtre n’a pas d’horloge de référence. Sinon, elle retourne la valeur de la méthode CBaseRenderer::ShouldDrawSampleNow . Dans la classe de base, ShouldDrawSampleNow retourne toujours S_FALSE. La classe dérivée peut remplacer ce comportement. Par exemple, si la classe dérivée implémente la gestion du contrôle qualité, elle peut retourner E_FAIL pour supprimer un échantillon.

Configuration requise

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

Voir aussi

CBaseRenderer, classe