Partager via


Méthode CDrawImage.DrawImage

[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 DrawImage méthode dessine une image vidéo dans la fenêtre vidéo.

Syntaxe

BOOL DrawImage(
   IMediaSample *pMediaSample
);

Paramètres

pMediaSample

Pointeur vers l’interface IMediaSample de l’exemple qui contient l’image.

Valeur renvoyée

Retourne TRUE en cas de réussite ou FALSE dans le cas contraire.

Notes

Cette méthode délègue à CDrawImage::FastRender ou CDrawImage::SlowRender, selon que le filtre possède ou non l’allocateur qui a fourni l’exemple. Si le filtre possède l’allocateur, l’exemple est garanti comme un objet CImageSample . Dans ce cas, l’exemple utilise la mémoire partagée allouée par GDI, et l’image peut être dessinée à l’aide de BitBlt ou StretchBlt. Sinon, les images doivent être dessinées à l’aide des fonctions SetDIBitsToDevice ou StretchDIBits plus lentes .

Dans les builds de débogage, cette méthode appelle DisplaySampleTimes pour dessiner les horodatages de l’exemple sur l’image vidéo.

Configuration requise

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

Voir aussi

CDrawImage, classe

CDrawImage::UsingImageAllocator