IAMGraphStreams ::FindUpstreamInterface, méthode (strmif.h)

Article
03/04/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.]

La FindUpstreamInterface méthode recherche dans le graphique de filtre une interface spécifiée, amont à partir d’une broche spécifiée.

Syntaxe

HRESULT FindUpstreamInterface(
  [in]  IPin   *pPin,
  [in]  REFIID riid,
  [out] void   **ppvInterface,
  [in]  DWORD  dwFlags
);

Paramètres

[in] pPin

Pointeur vers l’interface IPin d’une broche. La broche doit appartenir à un filtre dans le graphe de filtre.

[in] riid

Référence à un identificateur d’interface (IID) qui spécifie l’interface à rechercher.

[out] ppvInterface

Adresse d’un pointeur void. Si la méthode réussit, cette variable reçoit un pointeur vers l’interface spécifiée par riid.

[in] dwFlags

Combinaison d’indicateurs de l’énumération AM_INTF_SEARCH_FLAGS , spécifiant les éléments à rechercher (épingles ou filtres).

Valeur retournée

Retourne l’une des valeurs HRESULT suivantes.

Code de retour	Description
E_NOINTERFACE	Interface introuvable.
E_POINTER	Pointeur non valide.
S_OK	Réussite.

Remarques

Si dwFlags est égal à zéro, cette méthode recherche l’interface dans l’ordre suivant :

Il interroge la broche spécifiée par pPin.
Si pPin est une broche d’entrée, il appelle FindUpstreamInterface de manière récursive sur la broche de sortie connectée à pPin, le cas échéant.
Si pPin est une broche de sortie, il interroge le filtre propriétaire de pPin. Ensuite, il crée une liste de broches d’entrée sur le filtre qui ont des connexions internes à pPin et appelle FindUpstreamInterface de manière récursive sur ces broches d’entrée.

Pour créer une liste de broches d’entrée avec des connexions internes, la méthode effectue les opérations suivantes :
- Appelle IPin ::QueryInternalConnections.
- Si cela échoue, appelle IBaseFilter ::EnumPins et recherche des broches d’entrée.

Il s’arrête au premier objet qu’il trouve qui prend en charge l’interface. Vous pouvez limiter les objets recherchés (filtres, broches d’entrée ou broches de sortie) en définissant dwFlags sur une valeur autre que zéro.

Note La méthode ICaptureGraphBuilder2 ::FindInterface implémente une approche plus générale de ce problème et est recommandée dans la plupart des cas.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [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

IAMGraphStreams Interface

Partager via