IRenderEngine::GetFilterGraph

 
Microsoft DirectShow 9.0

IRenderEngine::GetFilterGraph

The GetFilterGraph method retrieves the filter graph that the render engine has constructed, if any.

Syntax

  HRESULT GetFilterGraph(
    IGraphBuilder **ppFG
);

Parameters

ppFG

[out] Address of a pointer to receive the filter graph's IGraphBuilder interface. It receives the value NULL if there is no filter graph.

Return Value

Returns one of the following HRESULT values:

Value Description
S_OK Success.
E_MUST_INIT_RENDERER Render engine failed to initialize.
E_POINTER Invalid pointer.

Remarks

Use the IRenderEngine::ConnectFrontEnd method to build the front end of the filter graph. For preview, use the IRenderEngine::RenderOutputPins to complete the graph. For file output, connect the front end to a mux/file writer combination. For more information, see Rendering a Project.

The resulting graph can be run, paused, stopped, and seeked; the playback rate cannot be changed, however.

On return, if the value of *ppFG is non-NULL, the IGraphBuilder interface has an outstanding reference count. Be sure to release the interface when you are finished using it.

Requirements

Header: Include Qedit.h. This header file is not compatible with Microsoft® Direct3D® headers later than version 7.

Library: Use strmiids.lib.

See Also