DirectX SDK

IDirectMusicTool

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

Requirements

  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.

See Also

Overview of DirectMusic Data Flow, Message Creation and Delivery, DirectMusic Tools