IXMLGraphBuilder interface (amxmlgraphbuilder.h)

  • Article

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The IXMLGraphBuilder interface is used to persist a DirectShow filter graph using an XML file format.

Note  Support for this interface was removed in Windows 7. New applications should not use this interface.
 

Inheritance

The IXMLGraphBuilder interface inherits from the IUnknown interface. IXMLGraphBuilder also has these types of members:

Methods

The IXMLGraphBuilder interface has these methods.

 
IXMLGraphBuilder::BuildFromXML

The BuildFromXML method loads a filter graph from an XML element.
IXMLGraphBuilder::BuildFromXMLFile

The BuildFromXMLFile method loads a filter graph from an XML file.
IXMLGraphBuilder::SaveToXML

The SaveToXML method saves a filter graph to an XML element.

Remarks

To get a pointer to this interface, call CoCreateInstance with the class identifier CLSID_XMLGraphBuilder.

The recommended way to save and load a filter graph is to use the GraphEdit file format:

Generally, you should persist a filter graph only for testing purposes and not for production. There is no consistently reliable way to reload a filter graph from a file, because the user's hardware and software configurations can change between sessions. Therefore, except for testing, an application should always build a filter graph programmatically.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header amxmlgraphbuilder.h