ICaptureGraphBuilder ::FindInterface, méthode (strmif.h)

Article
03/02/2024

[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.]

NoteL’interface ICaptureGraphBuilder est déconseillée. Utilisez plutôt ICaptureGraphBuilder2 .

Recherche l’interface spécifiée sur le filtre, amont et en aval du filtre, et, éventuellement, uniquement sur l’épingle de sortie de la catégorie donnée.

Syntaxe

HRESULT FindInterface(
  [in]  const GUID  *pCategory,
  [in]  IBaseFilter *pf,
  [in]  REFIID      riid,
  [out] void        **ppint
);

Paramètres

[in] pCategory

Pointeur vers un GUID spécifiant la catégorie de broche de sortie. Consultez Pin Property Set pour obtenir la liste de toutes les catégories de broches. NULL indique rechercher toutes les broches de sortie, quelle que soit la catégorie.

[in] pf

Pointeur vers l’interface IBaseFilter du filtre.

[in] riid

ID de référence de l’interface souhaitée.

[out] ppint

Adresse d’un pointeur void. Si l’interface a été trouvée, cette méthode initialise le pppnt afin qu’il contienne l’adresse d’un pointeur vers l’interface trouvée. Appelez la méthode Release pour décrémenter le nombre de références lorsque vous avez terminé l’interface.

Valeur retournée

Retourne une valeur HRESULT .

Remarques

Cette méthode recherche l’interface sur le filtre et amont et en aval du filtre, sauf si une catégorie est donnée. Si une catégorie est donnée, elle apparaît uniquement en aval de la broche de sortie de cette catégorie. Il peut être utilisé pour rechercher des interfaces sur les convertisseurs, les multiplexeurs, les tuners TV, les barres croisées, etc.

Si pCategory est égal à &LOOK_UPSTREAM_ONLY, le générateur de graphiques recherchera amont du filtre donné dans le paramètre pf, mais pas sur le filtre lui-même, ni en aval du filtre.

Si pCategory est égal à &LOOK_DOWNSTREAM_ONLY, le générateur de graphiques regardera en aval du filtre donné dans le paramètre pf, mais pas sur le filtre lui-même, ni amont du filtre.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)

Voir aussi

Codes d’erreur et de réussite

ICaptureGraphBuilder, interface

Partager via