CBasePin.Connect, méthode

Article
07/28/2023

[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 l’épingle à une autre broche. Cette méthode implémente la méthode IPin::Connect .

Syntaxe

HRESULT Connect(
         IPin          *pReceivePin,
   const AM_MEDIA_TYPE *pmt
);

Paramètres

pReceivePin: Pointeur vers l’interface IPin de l’épingle de réception.
Pmt: Pointeur vers une structure AM_MEDIA_TYPE qui spécifie le type de média pour la connexion.

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles incluent celles du tableau suivant.

Code de retour	Description
S_OK	Opération réussie.
VFW_E_ALREADY_CONNECTED	La broche est déjà connectée.
VFW_E_NO_ACCEPTABLE_TYPES	Impossible de trouver un type de média acceptable.
VFW_E_NOT_STOPPED	Le filtre est actif et l’épingle ne prend pas en charge la reconnexion dynamique.
VFW_E_TYPE_NOT_ACCEPTED	Le type de média spécifié n’est pas acceptable.

Notes

Le paramètre pmt peut être NULL. Il peut également spécifier un type de média partiel, avec la valeur GUID_NULL pour le type principal, le sous-type ou le format.

Dans la classe de base, cette méthode teste si la broche est déjà connectée et si le filtre est arrêté. Il délègue le reste du processus de connexion à la méthode CBasePin::AgreeMediaType .

Configuration requise

Condition requise	Valeur
En-tête	Amfilter.h (include Streams.h)
Bibliothèque	Strmbase.lib (builds de vente au détail) ; Strmbasd.lib (builds de débogage)

Voir aussi

CBasePin, classe

Partager via