Méthode IFilterGraph2 ::RenderEx (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 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

Voir aussi

Codes d’erreur et de réussite

IFilterGraph2, interface

Partager via