Classe CBaseControlVideo

[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 classe CBaseControlVideo implémente l’interface IBasicVideo et contrôle les propriétés vidéo d’une fenêtre vidéo générique. En règle générale, un objet CBaseControlVideo est un convertisseur vidéo qui dessine la vidéo dans une fenêtre de l’écran.

De nombreuses fonctions membres de CBaseControlVideo nécessitent uniquement que le convertisseur vidéo soit connecté à un graphe de filtre. Si elle n’est pas connectée, les fonctions membres retournent VFW_E_NOT_CONNECTED. Les propriétés définies sur un convertisseur vidéo persistent entre les connexions successives et les déconnexions. Toutes les applications doivent s’assurer qu’elles réinitialisent les propriétés du convertisseur avant de commencer une présentation.

Lors de l’utilisation de la vidéo, l’application peut sélectionner une partie de la vidéo à utiliser. Cette partie est le rectangle source que l’objet CBaseControlVideo contrôle. CBaseControlVideo permet à votre application de définir et de récupérer le rectangle source. Tous les rectangles que CBaseControlVideo utilise utilisent des valeurs de largeur et de hauteur plutôt que des valeurs de droite et de bas. Lorsqu’aucun rectangle source n’a été défini, les propriétés du rectangle source retournent la taille vidéo native complète.

Membres de données protégés	Description
m_pFilter	Pointeur vers un filtre multimédia propriétaire.
m_pInterfaceLock	Section critique définie en externe.
m_pPin	Contrôle des types de médias pour la connexion.
Fonctions de membre	Description
CBaseControlVideo	Construit un objet CBaseControlVideo .
CopyImage	Crée une copie en mémoire d’une image vidéo.
GetImageSize	Récupère les informations sur la taille de l’image vidéo.
SetControlVideoPin	Définit le code pin avec lequel cet objet doit se synchroniser.
Fonctions membres substituables	Description
CheckSourceRect	Détermine si un rectangle source est valide.
CheckTargetRect	Détermine si un rectangle cible est valide.
GetSourceRect	Récupère le rectangle vidéo source actuel (virtuel pur).
GetStaticImage	Retourne l’image actuelle dans une mémoire tampon (virtuelle pure).
GetTargetRect	Récupère le rectangle vidéo cible actuel (virtuel pur).
GetVideoFormat	Récupère la structure VIDEOINFOHEADER contenant le format vidéo.
IsDefaultSourceRect	Détermine si le convertisseur utilise le rectangle source par défaut (virtuel pur).
IsDefaultTargetRect	Détermine si le convertisseur utilise le rectangle cible par défaut (virtuel pur).
OnUpdateRectangles	Appelé lorsque le rectangle source ou cible change.
OnVideoSizeChange	Transmet EC_VIDEO_SIZE_CHANGED à l’application.
SetDefaultSourceRect	Définit le rectangle vidéo source par défaut (virtuel pur).
SetDefaultTargetRect	Définit le rectangle vidéo cible par défaut (virtuel pur).
SetSourceRect	Définit le rectangle vidéo source actuel (virtuel pur).
SetTargetRect	Définit le rectangle cible actuel (virtuel pur).
Méthodes IBasicVideo	Description
get_AvgTimePerFrame	Récupère une durée moyenne approximative par image.
get_BitErrorRate	Récupère un taux d’erreur de bits approximatif.
get_BitRate	Récupère un débit binaire approximatif pour la vidéo.
GetCurrentImage	Récupère un rendu de mémoire de l’image actuelle.
get_DestinationHeight	Récupère la hauteur du rectangle de destination actuel.
get_DestinationLeft	Récupère la coordonnée gauche du rectangle de destination actuel.
GetDestinationPosition	Récupère la position de destination actuelle.
get_DestinationTop	Récupère la coordonnée supérieure du rectangle de destination actuel.
get_DestinationWidth	Récupère la largeur du rectangle de destination actuel.
get_SourceHeight	Récupère la hauteur du rectangle source actuel.
get_SourceLeft	Récupère la coordonnée gauche du rectangle source actuel.
GetSourcePosition	Récupère la position source actuelle.
get_SourceTop	Récupère la coordonnée supérieure du rectangle source actuel.
get_SourceWidth	Récupère la largeur du rectangle source actuel.
get_VideoHeight	Récupère la hauteur de la vidéo native.
GetVideoPaletteEntries	Récupère une plage d’entrées de palette pour la vidéo.
GetVideoSize	Récupère la largeur et la hauteur de la vidéo native.
get_VideoWidth	Récupère la largeur de la vidéo native.
IsUsingDefaultDestination	Détermine si le convertisseur utilise la fenêtre de destination par défaut.
IsUsingDefaultSource	Détermine si le convertisseur utilise la fenêtre source par défaut.
put_DestinationHeight	Définit la hauteur du rectangle de destination.
put_DestinationLeft	Définit la coordonnée gauche du rectangle de destination.
put_DestinationTop	Définit la coordonnée supérieure du rectangle de destination.
put_DestinationWidth	Définit la largeur du rectangle de destination.
put_SourceHeight	Définit la hauteur du rectangle source.
put_SourceLeft	Définit la coordonnée gauche du rectangle source.
put_SourceTop	Définit la coordonnée supérieure du rectangle source.
put_SourceWidth	Définit la largeur du rectangle source.
SetDefaultDestinationPosition	Définit à nouveau la position de destination par défaut.
SetDefaultSourcePosition	Définit à nouveau la position source par défaut.
SetDestinationPosition	Définit la position du rectangle de destination.
SetSourcePosition	Définit la position du rectangle source.

 

Voir aussi

DirectShow Base Classes