Microsoft DirectX 9.0 SDK Update (October 2004)

IDirectMusicTool8 Interface

The IDirectMusicTool8 interface represents a tool object that processes messages.

Methods of this interface are implemented by tools 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
Clone Creates a new instance of the tool.
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 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.
Init Initializes the tool.
ProcessPMsg Performs the main task of the tool.

Requirements

  Header: Declared in dmplugin.h.

See Also


© 2004 Microsoft Corporation. All rights reserved.