IGraphBuilder ::Connect, méthode (strmif.h)

Article
03/04/2024

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

Code de retour	Description
S_OK	Réussite.
VFW_S_PARTIAL_RENDER	Réussite partielle ; certains flux de cette broche utilisent un format non pris en charge.
E_ABORT	Opération abandonnée.
E_POINTER	Argument pointeur NULL .
VFW_E_CANNOT_CONNECT	Aucune combinaison de filtres intermédiaires n’a pu être trouvée pour établir la connexion.
VFW_E_NOT_IN_GRAPH	Au moins l’un des filtres ne figure pas dans le graphique de filtre.

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

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	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IGraphBuilder, interface

Partager via