Méthode CBaseRenderer.ShouldDrawSampleNow

  • 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 ShouldDrawSampleNow méthode détermine comment un exemple est planifié pour le rendu.

Syntaxe

virtual HRESULT ShouldDrawSampleNow(
   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 contient l’heure de début de l’exemple.

pEndTime

Pointeur vers une variable qui contient l’heure de fin de l’exemple.

Valeur renvoyée

Retourne S_FALSE. Si la classe dérivée remplace cette méthode, retournez l’une des valeurs 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.
Code d’erreur
 N’affichez pas cet exemple.

Notes

La méthode CBaseRenderer::GetSampleTimes appelle cette méthode. Par défaut, les exemples sont toujours planifiés pour le rendu en fonction de leurs horodatages. La classe dérivée peut remplacer cette méthode ; par exemple, pour implémenter le contrôle qualité.

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