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