Méthode CBaseControlVideo.GetDestinationPosition

  • Article

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

La GetDestinationPosition méthode récupère le rectangle de destination en une seule opération atomique.

Syntaxe

HRESULT GetDestinationPosition(
   long *pLeft,
   long *pTop,
   long *pWidth,
   long *pHeight
);

Paramètres

pLeft

Pointeur vers la coordonnée gauche du rectangle de destination.

pTop

Pointeur vers la coordonnée supérieure du rectangle de destination.

pWidth

Pointeur vers la largeur du rectangle de destination.

pHeight

Pointeur vers la hauteur du rectangle de destination.

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_POINTER
 Argument pointeur NULL .
VFW_E_NOT_CONNECTED
 Impossible d’effectuer l’opération, car les broches ne sont pas connectées.
NOERROR
 Opération réussie.

Notes

Cette fonction membre peut être utilisée à la place d’appels distincts aux fonctions membres CBaseControlVideo::get_DestinationLeft, CBaseControlVideo::get_DestinationTop, CBaseControlVideo::get_DestinationWidth et CBaseControlVideo::get_DestinationHeight . 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’affichera lors de la lecture. 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

CBaseControlVideo, classe