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