Partager via


Méthode CBaseControlVideo.GetCurrentImage

[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 GetCurrentImage méthode récupère une copie de l’image actuelle au niveau du convertisseur.

Syntaxe

HRESULT GetCurrentImage(
   long *pBufferSize,
   long *pVideoImage
);

Paramètres

pBufferSize

Pointeur vers la taille de la mémoire tampon de sortie.

pVideoImage

Pointeur vers la mémoire tampon de sortie de l’image.

Valeur renvoyée

Retourne une valeur HRESULT qui dépend de l’implémentation ; peut être l’une des valeurs suivantes ou d’autres valeurs non répertoriées.

Code de retour Description
E_FAIL
Échec.
E_INVALIDARG
Argument non valide.
E_OUTOFMEMORY
Mémoire insuffisante. Retourné lorsque le paramètre pVideoInfo a la valeur NULL.
NOERROR
Opération réussie.
VFW_E_NOT_PAUSED
L’opération n’a pas pu être effectuée, car le filtre n’est pas suspendu.

Notes

Cette fonction membre récupère l’image de l’exemple et la copie dans la mémoire tampon de sortie. La section de la vidéo copiée dans la mémoire tampon de sortie reflète le rectangle source défini via l’interface IBasicVideo . Il ne reflète pas le rectangle de destination.

Configuration requise

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

Voir aussi

Classe CBaseControlVideo