Microsoft DirectX 9.0

IRenderEngine Interface

The IRenderEngine interface renders a DirectShow Editing Services (DES) project by constructing a filter graph from a timeline.

DES provides two components that implement this interface:

The basic render engine creates uncompressed output. You can use the output for preview, or route it through compression filters and write it to a file.
The smart render engine creates compressed output, using smart recompression. With smart recompression, a source file is recompressed only if its format differs from the output format. A source with a matching format is written directly to the output file. Depending on the scenario, smart recompression can greatly improve rendering time.

The smart render engine also supports the ISmartRenderEngine interface.

Although an application can create a filter graph and pass it to a render engine, the typical scenario is for the render engine to create the filter graph. Building the graph is a two-stage process. First, build the front end by calling the IRenderEngine::ConnectFrontEnd method. Then connect the output pins on the front end to the desired rendering filters:

Video and audio renderers for preview, or
Compressors, multiplexers, and file writers to generate the final output.

In addition to the methods inherited from IUnknown, the IRenderEngine interface exposes the following methods.

Method	Description
Commit	Not implemented.
ConnectFrontEnd	Builds the front end of the filter graph from the current timeline.
Decommit	Not implemented.
DoSmartRecompression	Not supported.
GetCaps	Not implemented.
GetFilterGraph	Retrieves the filter graph that the render engine has constructed, if any.
GetGroupOutputPin	Retrieves the output pin for the specified group.
GetTimelineObject	Retrieves the timeline that the render engine is currently using.
GetVendorString	Retrieves the vendor string.
RenderOutputPins	Creates the previewing portion of the filter graph.
ScrapIt	Discards the render engine's filter graph and all associated objects.
SetDynamicReconnectLevel	Sets the level of dynamic reconnection during rendering.
SetFilterGraph	Specifies a filter graph for the render engine to use.
SetInterestRange	Not supported.
SetInterestRange2	Not supported.
SetRenderRange	Sets the range of time to be rendered.
SetRenderRange2	Sets the range of time to be rendered, as a double.
SetSourceConnectCallback	Not supported.
SetSourceNameValidation	Specifies how the render engine validates file names.
SetTimelineObject	Sets the timeline for the render engine to use.
UseInSmartRecompressionGraph	Not supported.

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

Rendering a Project