IAMGraphStreams ::FindUpstreamInterface, 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 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 |
---|---|
|
Interface introuvable. |
|
Pointeur non valide. |
|
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.
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 |