Interface IBasicVideo (control.h)

[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.]

L’interface IBasicVideo définit les propriétés vidéo telles que les rectangles de destination et de source. Les filtres Video Renderer et Video Mixing Renderer implémentent cette interface, mais l’interface est exposée aux applications via le Gestionnaire de graphe de filtres. Les applications doivent toujours récupérer cette interface à partir du Gestionnaire de graphes de filtres.

L’interface IBasicVideo manipule les rectangles suivants associés à l’image vidéo :

  • Le rectangle source est la partie de l’image d’origine qui s’affiche.
  • Le rectangle de destination est la partie de la fenêtre vidéo que reçoit le rectangle source.
  • Le rectangle vidéo est l’image vidéo d’origine.
En d’autres termes, le convertisseur vidéo rogne l’image dans le rectangle source, puis étend ou réduit l’image rognée au rectangle de destination. Toutes les dimensions de rectangle sont données en pixels.

Les propriétés définies sur le convertisseur vidéo sont conservées entre les connexions et les déconnexions successives.

Codes d’erreur : si le filtre du convertisseur vidéo n’est pas connecté à un autre filtre, toutes les méthodes retournent le code d’erreur VFW_E_NOT_CONNECTED. Pour l’implémentation du Gestionnaire de graphe de filtre, si le graphe ne contient pas de filtre de convertisseur vidéo, toutes les méthodes retournent E_NOINTERFACE. Notez que le Gestionnaire de graphe de filtre expose l’interface même lorsque le graphique ne contient pas de convertisseur vidéo. Une application peut donc interroger l’interface avant de générer le graphe.

Héritage

L’interface IBasicVideo hérite de l’interface IDispatch . IBasicVideo a également les types de membres suivants :

Méthodes

L’interface IBasicVideo a ces méthodes.

 
IBasicVideo ::get_AvgTimePerFrame

La méthode get_AvgTimePerFrame récupère le temps moyen entre les images successives.
IBasicVideo ::get_BitErrorRate

La méthode get_BitErrorRate récupère le taux d’erreur binaire approximatif du flux vidéo.
IBasicVideo ::get_BitRate

La méthode get_BitRate récupère la vitesse de transmission approximative du flux vidéo.
IBasicVideo ::get_DestinationHeight

La méthode get_DestinationHeight récupère la hauteur du rectangle de destination.
IBasicVideo ::get_DestinationLeft

La méthode get_DestinationLeft récupère la coordonnée x du rectangle de destination.
IBasicVideo ::get_DestinationTop

La méthode get_DestinationTop récupère la coordonnée y du rectangle de destination.
IBasicVideo ::get_DestinationWidth

La méthode get_DestinationWidth récupère la largeur du rectangle de destination.
IBasicVideo ::get_SourceHeight

La méthode get_SourceHeight récupère la hauteur du rectangle source.
IBasicVideo ::get_SourceLeft

La méthode get_SourceLeft récupère la coordonnée x du rectangle source.
IBasicVideo ::get_SourceTop

La méthode get_SourceTop récupère la coordonnée y du rectangle source.
IBasicVideo ::get_SourceWidth

La méthode get_SourceWidth récupère la largeur du rectangle source.
IBasicVideo ::get_VideoHeight

La méthode get_VideoHeight récupère la hauteur native de la vidéo.
IBasicVideo ::get_VideoWidth

La méthode get_VideoWidth récupère la largeur native de la vidéo.
IBasicVideo ::GetCurrentImage

La méthode GetCurrentImage récupère l’image actuelle en attente au niveau du convertisseur.
IBasicVideo ::GetDestinationPosition

La méthode GetDestinationPosition récupère la position du rectangle de destination.
IBasicVideo ::GetSourcePosition

La méthode GetSourcePosition récupère la position du rectangle source.
IBasicVideo ::GetVideoPaletteEntries

La méthode GetVideoPaletteEntries récupère les couleurs de palette de la vidéo.
IBasicVideo ::GetVideoSize

La méthode GetVideoSize récupère les dimensions vidéo natives.
IBasicVideo ::IsUsingDefaultDestination

La méthode IsUsingDefaultDestination interroge si le convertisseur utilise le rectangle de destination par défaut.
IBasicVideo ::IsUsingDefaultSource

La méthode IsUsingDefaultSource interroge si le convertisseur utilise le rectangle source par défaut.
IBasicVideo ::p ut_DestinationHeight

La méthode put_DestinationHeight définit la hauteur du rectangle de destination.
IBasicVideo ::p ut_DestinationLeft

La méthode put_DestinationLeft définit la coordonnée x du rectangle de destination.
IBasicVideo ::p ut_DestinationTop

La méthode put_DestinationTop définit la coordonnée y du rectangle de destination.
IBasicVideo ::p ut_DestinationWidth

La méthode put_DestinationWidth définit la largeur du rectangle de destination.
IBasicVideo ::p ut_SourceHeight

La méthode put_SourceHeight définit la hauteur du rectangle source.
IBasicVideo ::p ut_SourceLeft

La méthode put_SourceLeft définit la coordonnée x du rectangle source.
IBasicVideo ::p ut_SourceTop

La méthode put_SourceTop définit la coordonnée y du rectangle source.
IBasicVideo ::p ut_SourceWidth

La méthode put_SourceWidth définit la largeur du rectangle source.
IBasicVideo ::SetDefaultDestinationPosition

La méthode SetDefaultDestinationPosition rétablit le rectangle de destination par défaut. Une fois cette méthode appelée, le convertisseur vidéo utilise la fenêtre entière pour la lecture.
IBasicVideo ::SetDefaultSourcePosition

La méthode SetDefaultSourcePosition rétablit le rectangle source par défaut. Une fois cette méthode appelée, le convertisseur vidéo utilise l’image vidéo entière, sans rognage.
IBasicVideo ::SetDestinationPosition

La méthode SetDestinationPosition définit le rectangle de destination.
IBasicVideo ::SetSourcePosition

La méthode SetSourcePosition définit le rectangle source.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête control.h (include Dshow.h)

Voir aussi

IDispatch