IFilterGraph2::RenderEx

  • Article
 
Microsoft DirectShow 9.0

IFilterGraph2::RenderEx

The RenderEx method renders an output pin, with an option to use existing renderers only.

Syntax

  HRESULT RenderEx(
  IPin *
  pPinOut
  ,
  DWORD 
  dwFlags
  ,
  DWORD *
  pvContext

  );

Parameters

pPinOut

[in] Pointer to the IPin interface of the output pin.

dwFlags

[in] Flag that specifies how to render the pin. If the value is AM_RENDEREX_RENDERTOEXISTINGRENDERERS, the method attempts to use renderers already in the filter graph. It will not add new renderers to the graph. (It will add intermediate transform filters, if needed.) For the method to succeed, the graph must contain the appropriate renderers, and they must have unconnected input pins. If the value is zero, the method behaves identically to the IGraphBuilder::Render method.

pvContext

[in, out] Reserved. Must be NULL.

Return Values

Returns an HRESULT.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also