| Microsoft DirectX 8.1 (C++) |
The IDirectMusicTool8 interface represents a tool object that processes messages. The tool can modify a message, create additional messages, remove messages, and so on.
This interface is of interest chiefly to developers who want to create their own tools. Methods of the interface are implemented by the designer of the tool and are generally called by the performance. The application only needs to insert the tool in the message path by using IDirectMusicGraph8::InsertTool.
IDirectMusicTool8 supersedes the IDirectMusicTool interface and adds a new method.
In addition to the methods inherited from IUnknown, the IDirectMusicTool8 interface exposes the following methods.
| Method | Description |
| Flush | Flushes messages from the queue when the performance stops. |
| GetMediaTypeArraySize | Retrieves the size of the array that must be passed in to the IDirectMusicTool8::GetMediaTypes_dx_IDirectMusicTool8_GetMediaTypes_dxaudio method. |
| GetMediaTypes | Retrieves a list of the types of messages that this tool supports. |
| GetMsgDeliveryType | Retrieves the tool's delivery type, which determines when messages are to be delivered to the tool. |
| ProcessPMsg | Performs the main task of the tool. |
| Method | Description |
| Init | Initializes the tool. |
| Clone | Creates a new instance of the tool. |
Requirements
Header: Declared in dmplugin.h.
See Also