Share via


IBasicVideo ::p ut_SourceLeft, méthode (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.]

La put_SourceLeft méthode définit la coordonnée x du rectangle source.

Syntaxe

HRESULT put_SourceLeft(
  [in] long SourceLeft
);

Paramètres

[in] SourceLeft

Spécifie la coordonnée x, en pixels.

Valeur retournée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour Description
E_INVALIDARG
Argument non valide.
S_OK
Réussite.
VFW_E_NOT_CONNECTED
La broche d’entrée du convertisseur vidéo n’est pas connectée.

Remarques

Cette méthode déplace l’intégralité du rectangle source vers la gauche ou la droite. Elle ne modifie pas la largeur du rectangle source. Si la valeur de SourceLeft place le bord droit du rectangle au-delà du bord de l’image vidéo, la méthode retourne E_INVALIDARG. Pour rogner la vidéo, appelez put_SourceWidth pour ajuster la largeur, avant d’appeler put_SourceLeft. (Ou appelez SetSourcePosition pour définir l’intégralité du rectangle source à la fois.)

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)
Bibliothèque Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IBasicVideo, interface