Méthode CBaseControlVideo.GetImageSize

Article
07/28/2023

[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 GetImageSize méthode récupère les informations sur la taille de l’image vidéo.

Syntaxe

HRESULT GetImageSize(
   VIDEOINFOHEADER *pVideoInfo,
   long            *pBufferSize,
   RECT            *pSourceRect
);

Paramètres

pVideoInfo: Pointeur vers une structure VIDEOINFOHEADER à remplir.
pBufferSize: Pointeur vers la taille de la mémoire tampon vidéo.
pSourceRect: Pointeur vers les dimensions rectangle de la vidéo source.

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. Le format de données n’est pas compatible.
E_UNEXPECTED	Une erreur inattendue s'est produite. Un ou plusieurs arguments ont la valeur NULL.
NOERROR	Opération réussie.

Notes

Cette fonction membre est une fonction d’assistance utilisée pour créer des rendus d’image mémoire d’images DIB. Il est appelé à partir de l’implémentation de la classe de base de CBaseControlVideo::GetCurrentImage lorsqu’un paramètre pVideoImageNULL est passé à cette fonction membre. Par conséquent, cette fonction membre construit et retourne une structure VIDEOINFOHEADER à l’aide des informations contenues dans pBufferSize et pSourceRect.

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

Partager via