Microsoft DirectX 8.1 (C++)

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 Value

Returns an HRESULT.

See Also