IGraphBuilder ::Connect, méthode (strmif.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 Connect méthode connecte les deux broches, en utilisant des intermédiaires si nécessaire.

Syntaxe

HRESULT Connect(
  [in] IPin *ppinOut,
  [in] IPin *ppinIn
);

Paramètres

[in] ppinOut

Pointeur vers l’interface IPin sur la broche de sortie.

[in] ppinIn

Pointeur vers l’interface IPin sur la broche d’entrée.

Valeur retournée

Retourne un HRESULT. Les valeurs possibles sont les suivantes.

Remarques

Cette méthode connecte deux broches directement ou indirectement, en ajoutant des filtres intermédiaires si nécessaire. La méthode commence par tenter une connexion directe. En cas d’échec, il tente d’utiliser tous les filtres qui se trouvent déjà dans le graphique de filtre et qui ont des broches d’entrée non connectées. (Il les énumère dans un ordre arbitraire.) En cas d’échec, il recherche des filtres dans le registre et les essaie par ordre de mérite. Pour plus d’informations, consultez Intelligent Connect.

Pendant le processus de connexion, le Gestionnaire de graphes de filtre ignore les épingles sur les filtres intermédiaires si le nom de la broche commence par un tilde (~). Pour plus d’informations, consultez PIN_INFO.

Configuration requise

Voir aussi

Codes d’erreur et de réussite

IGraphBuilder, interface