CBaseFilter.FindPin, méthode

[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 FindPin méthode récupère l’épingle avec l’identificateur spécifié. Cette méthode implémente la méthode IBaseFilter::FindPin .

Syntaxe

HRESULT FindPin(
   LPCWSTR Id,
   IPin    **ppPin
);

Paramètres

Id

Pointeur vers une chaîne Unicode constante terminée par un caractère Null qui identifie l’épingle.

ppPin

Adresse d’une variable qui reçoit un pointeur vers l’interface IPin de l’épingle.

Valeur renvoyée

Retourne l’une des valeurs HRESULT suivantes.

Code de retour	Description
S_OK	Opération réussie.
E_POINTER	Argument pointeur NULL .
VFW_E_NOT_FOUND	Impossible de trouver une broche correspondante.

Notes

Cette méthode appelle la méthode CBasePin::Name pour comparer le nom de chaque épingle à la chaîne spécifiée par le paramètre Id .

Si la méthode réussit, l’interface IPin a un nombre de références en suspens. Veillez à le libérer lorsque vous avez terminé.

Configuration requise

Condition requise	Valeur
En-tête	Amfilter.h (include Streams.h)
Bibliothèque	Strmbase.lib (builds de vente au détail) ; Strmbasd.lib (builds de débogage)

Voir aussi

CBaseFilter, classe