Méthode IPin::Connect (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 l’épingle à une autre broche.
Les applications ne doivent pas appeler cette méthode. Utilisez plutôt des méthodes IGraphBuilder . Cette méthode est appelée par le Gestionnaire de graphes de filtre pour connecter des broches.
Syntaxe
HRESULT Connect(
[in] IPin *pReceivePin,
[in] const AM_MEDIA_TYPE *pmt
);
Paramètres
[in] pReceivePin
Pointeur vers l’interface IPin de l’épingle de réception.
[in] pmt
Pointeur vers une structure AM_MEDIA_TYPE qui spécifie le type de média pour la connexion. Peut être NULL.
Valeur renvoyée
Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
Opération réussie. |
|
La broche est déjà connectée. |
|
Impossible de trouver un type de média acceptable. |
|
Les broches ne peuvent pas convenir d’un transport, ou il n’y a pas d’allocateur pour la connexion. |
|
Le filtre est actif et l’épingle ne prend pas en charge la reconnexion dynamique. |
|
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.
Cette méthode vérifie que la connexion est possible. Si l’épingle rejette la connexion, la méthode échoue. La broche de connexion propose des types de médias en appelant IPin::ReceiveConnection sur le code confidentiel de réception.
Configuration requise
| 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 |