ICaptureGraphBuilder2::FindPin, méthode (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 dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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 FindPin méthode récupère une broche particulière sur un filtre ou détermine si une broche donnée correspond aux critères spécifiés.
Syntaxe
HRESULT FindPin(
[in] IUnknown *pSource,
[in] PIN_DIRECTION pindir,
[in] const GUID *pCategory,
[in] const GUID *pType,
[in] BOOL fUnconnected,
[in] int num,
[out] IPin **ppPin
);
Paramètres
[in] pSource
Pointeur vers une interface sur un filtre ou vers une interface sur une broche.
[in] pindir
Membre de l’énumération PIN_DIRECTION qui spécifie la direction de la broche (entrée ou sortie).
[in] pCategory
Pointeur vers un GUID qui spécifie l’une des catégories de broches répertoriées dans Pin Property Set. Pour faire correspondre n’importe quelle broche, quelle que soit la catégorie, définissez ce paramètre sur NULL.
[in] pType
Pointeur vers un GUID de type principal qui spécifie le type de média. Utilisez NULL pour correspondre à n’importe quel type de média.
[in] fUnconnected
Valeur booléenne qui spécifie si la broche doit être déconnectée. Si la valeur est TRUE, la broche doit être déconnectée. Si la valeur est FALSE, la broche peut être connectée ou non connectée.
[in] num
Index de base zéro de la broche à récupérer, à partir de l’ensemble de broches correspondantes. Si pSource est un pointeur vers un filtre et que plusieurs broches correspondent aux critères de recherche, ce paramètre spécifie l’épingle à récupérer. Si pSource est un pointeur vers une broche, ce paramètre est ignoré.
[out] ppPin
Adresse d’un pointeur pour recevoir l’interface IPin de la broche correspondante.
Valeur renvoyée
Retourne S_OK si une broche correspondante est trouvée, ou E_FAIL dans le cas contraire.
Notes
Si pSource est un pointeur vers un filtre, la méthode recherche le nième broche sur ce filtre qui correspond aux critères de recherche, où n est donné par le paramètre num . Si la méthode trouve une broche correspondante, elle retourne un pointeur vers la broche dans le paramètre ppPin .
Si pSource est un pointeur vers une broche, la méthode teste cette épingle par rapport aux critères de recherche. Si l’épingle correspond aux critères, la méthode retourne S_OK et retourne un pointeur vers l’interface IPin de la broche dans le paramètre ppPin . Sinon, il retourne E_FAIL.
Dans les deux cas, si la méthode réussit, l’interface IPin retournée dans le paramètre ppPin a un nombre de références en suspens. Veillez à libérer l’interface lorsque vous avez terminé de l’utiliser.
En règle générale, une application n’a pas besoin d’utiliser cette méthode. Il est fourni pour les tâches inhabituellement complexes, lorsque la méthode ICaptureGraphBuilder2::RenderStream ne peut pas générer le graphe de filtre. Utilisez cette méthode pour récupérer une broche souhaitée à partir d’un filtre de capture, puis générez manuellement le reste du graphique.
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 |