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