Méthode IPin::Connect (strmif.h)

  • Article

[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
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_NO_TRANSPORT
 Les broches ne peuvent pas convenir d’un transport, ou il n’y a pas d’allocateur pour la connexion.
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.

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

Voir aussi

Data Flow dans le graphe de filtres

Codes d’erreur et de réussite

IPin Interface