IXMLGraphBuilder interface (amxmlgraphbuilder.h)
[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.
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | amxmlgraphbuilder.h |