IDvdGraphBuilder Interface
| Microsoft DirectShow 9.0 |
IDvdGraphBuilder Interface
The IDvdGraphBuilder interface builds a filter graph for DVD-Video playback. The DVD Graph Builder object implements this interface.
The RenderDvdVideoVolume method builds a DVD playback graph 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.
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 interfaces from 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. |
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also