Interface IPin (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.]
Cette interface est exposée par toutes les broches d’entrée et de sortie.
Le gestionnaire de graphe de filtres utilise cette interface pour connecter des broches et effectuer des opérations de vidage. Les applications peuvent utiliser cette interface pour interroger l’épingle à la recherche d’informations. Les applications ne doivent jamais appeler IPin des méthodes qui modifient l’état d’une broche, telles que Connect, Disconnect, BeginFlush ou EndFlush. Pour connecter des broches, une application doit utiliser les méthodes dans IGraphBuilder.
Filtrer les développeurs : Les classes CBasePin, CBaseInputPin et CBaseOutputPin implémentent cette interface. D’autres classes de base dérivent de ces trois classes.
Héritage
L’interface IPin hérite de l’interface IUnknown. IPin a également les types de membres suivants :
Méthodes
L’interface IPin a ces méthodes.
| IPin ::BeginFlush La méthode BeginFlush commence une opération de vidage. (IPin.BeginFlush) |
| IPin ::Connect La méthode Connect connecte l’épingle à une autre broche. |
| IPin ::ConnectedTo La méthode ConnectedTo récupère un pointeur vers la broche connectée, le cas échéant. |
| IPin ::ConnectionMediaType La méthode ConnectionMediaType récupère le type de média pour la connexion d’épingle actuelle, le cas échéant. |
| IPin ::D isconnect La méthode Disconnect interrompt la connexion de broche actuelle. |
| IPin ::EndFlush La méthode EndFlush met fin à une opération de vidage. (IPin.EndFlush) |
| IPin ::EndOfStream La méthode EndOfStream avertit l’épingle qu’aucune donnée supplémentaire n’est attendue, jusqu’à ce qu’une nouvelle commande d’exécution soit émise pour le filtre. |
| IPin ::EnumMediaTypes La méthode EnumMediaTypes énumère les types de média préférés de l’épingle. |
| IPin ::NewSegment La méthode NewSegment avertit l’épingle que les exemples de médias reçus après cet appel sont regroupés sous forme de segment, avec une heure de début, une heure d’arrêt et une fréquence communes. |
| IPin ::QueryAccept La méthode QueryAccept détermine si l’épingle accepte un type de média spécifié. |
| IPin ::QueryDirection La méthode QueryDirection obtient la direction de la broche (entrée ou sortie). |
| IPin ::QueryId La méthode QueryId récupère un identificateur pour l’épingle. |
| IPin ::QueryInternalConnections La méthode QueryInternalConnections récupère les broches connectées en interne à cette broche (dans le filtre). |
| IPin ::QueryPinInfo La méthode QueryPinInfo récupère des informations sur l’épingle. |
| IPin ::ReceiveConnection La méthode ReceiveConnection accepte une connexion à partir d’une autre broche. |
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) |