Méthode CBaseControlVideo.SetDestinationPosition

[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 SetDestinationPosition méthode définit le rectangle de destination de la vidéo.

Syntaxe

HRESULT SetDestinationPosition(
   long Left,
   long Top,
   long Width,
   long Height
);

Paramètres

Left

Nouvelle coordonnée gauche.

Top

Nouvelle coordonnée supérieure.

Width

Nouvelle largeur.

Height

Nouvelle hauteur.

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.
E_POINTER	Argument pointeur NULL .
NOERROR	Opération réussie.
VFW_E_NOT_CONNECTED	L’opération ne peut pas être effectuée, car les broches ne sont pas connectées.

Notes

Une application peut modifier les rectangles source et de destination de la vidéo via l’interface IBasicVideo . Le rectangle source affecte la section de la source vidéo native qui apparaîtra sur l’affichage ; le rectangle de destination affecte l’emplacement où la vidéo s’affiche lorsqu’elle est lue. Le rectangle de destination est relatif à la zone cliente de la fenêtre dans laquelle il est en cours de lecture. Le coin supérieur gauche de la fenêtre est la coordonnée (0,0).

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