Méthode CSource.FindPin

  • 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 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 terminée par null qui identifie l’épingle.

ppPin

Reçoit un pointeur vers l’interface IPin de l’épingle. Si la méthode échoue, *ppPin a la valeur NULL

Valeur renvoyée

Retourne l’une des valeurs HRESULT indiquées dans le tableau suivant.

Code de retour Description
S_OK
 Opération réussie.
E_POINTER
 Argument pointeur NULL .
VFW_E_NOT_FOUND
 Impossible de trouver une épingle avec cet identificateur.

Notes

La première broche est toujours nommée « 1 » ; la deuxième broche est nommée « 2 » ; et ainsi de suite. Pour plus d’informations, consultez CSourceStream::QueryId.

Configuration requise

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

Voir aussi

CSource, classe