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

Voir aussi

Codes d’erreur et de réussite

ICaptureGraphBuilder2, interface