DirectX SDK

IDirectMusicBand

The IDirectMusicBand interface represents a DirectMusic band object. A band is used to set the instrument choices and mixer settings for a set of PChannels. For an overview, see Using Bands.

Bands can come from several places. They can be stored directly in their own files or embedded in a style's band list or a segment's band track.

The DirectMusicBand object also supports the IPersistStream and IDirectMusicObject interfaces for loading its data.

The IDirectMusicBand interface has the following methods:

Segment creation CreateSegment
Instrument data Download
  Unload

All COM interfaces inherit the IUnknown interface methods. This interface supports the following three methods:

IUnknown AddRef
  QueryInterface
Release

The LPDMUS_BAND type is defined as a pointer to the IDirectMusicBand interface.

typedef IDirectMusicBand __RPC_FAR *LPDMUS_BAND;

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.