Microsoft DirectX 9.0

IDvdGraphBuilder Interface

The IDvdGraphBuilder interface is implemented on the DVD Graph Builder object. The RenderDvdVideoVolume method automatically builds a filter graph for DVD-Video playback from the available software and hardware on the system. For information on how to build the DVD filter graph and obtain the pointers to all the necessary interfaces, see Building the DVD Filter Graph. The DVDSample application also demonstrates this process in DvdCore.cpp.

Note  A DVD filter graph requires either a hardware or software MPEG-2 decoder, which DirectShow does not provide. You must install a DirectShow-compatible third-party decoder on your computer before attempting to build the DVD filter graph.

Generally, you should not add, remove, connect, disconnect, or access individual filters in the graph created by RenderDvdVideoVolume, because doing so might confuse the cleanup code. The purpose of the DvdGraphBuilder object is to simplify the developement of DVD-Video applications. If you need a specific type of graph for a particular solution, you should manually create the entire filter graph.

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

Method Description
GetFiltergraph Retrieves the IGraphBuilder interface for the filter graph used by the DVD-Video graph builder object.
GetDvdInterface Retrieves specific interface pointers in the DVD-Video playback graph to make DVD-Video playback development easier.
RenderDvdVideoVolume Completes building a filter graph according to user specifications for playing a DVD-Video volume.