Méthode IFilterGraph2 ::RenderEx (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 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 RenderEx méthode restitue une broche de sortie, avec une option permettant d’utiliser uniquement des renderers existants.
Syntaxe
HRESULT RenderEx(
[in] IPin *pPinOut,
[in] DWORD dwFlags,
[in, out] DWORD *pvContext
);
Paramètres
[in] pPinOut
Pointeur vers l’interface IPin de la broche de sortie.
[in] dwFlags
Indicateur qui spécifie comment afficher l’épingle. Si la valeur est AM_RENDEREX_RENDERTOEXISTINGRENDERERS, la méthode tente d’utiliser des convertisseurs déjà présents dans le graphique de filtre. Il n’ajoute pas de nouveaux convertisseurs au graphique. (Il ajoute des filtres de transformation intermédiaires, si nécessaire.) Pour que la méthode réussisse, le graphique doit contenir les convertisseurs appropriés et ils doivent avoir des broches d’entrée non connectées. Si la valeur est zéro, la méthode se comporte de façon identique à la méthode IGraphBuilder ::Render .
[in, out] pvContext
Réservé. Doit être NULL.
Valeur retournée
Retourne un HRESULT.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | strmif.h (include Dshow.h) |
| Bibliothèque | Strmiids.lib |