Tools are objects that implement the IDirectMusicTool interface. They are used inside graphs (see IDirectMusicGraph). When a message is sent using IDirectMusicPerformance::SendPMsg, the message flows through tools inside graphs. The tools can modify the message, make additional messages, remove messages, and so on.
This interface is of most interest to developers who want to create their own tools.
The methods of the IDirectMusicTool interface can be organized in the following groups:
| Initialization | Init |
| Message management | Flush |
| GetMediaTypeArraySize | |
| GetMediaTypes | |
| GetMsgDeliveryType | |
| ProcessPMsg |
All COM interfaces inherit the IUnknown interface methods. This interface supports the following three methods:
| IUnknown | AddRef |
| QueryInterface | |
| Release |
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in dmusici.h.
Overview of DirectMusic Data Flow, Message Creation and Delivery, DirectMusic Tools