DMUS_IO_INSTRUMENT

The DMUS_IO_INSTRUMENT structure contains information about an instrument. It is used in the Band Form.

typedef struct _DMUS_IO_INSTRUMENT {
    DWORD  dwPatch;
    DWORD  dwAssignPatch;
    DWORD  dwNoteRanges[4];
    DWORD  dwPChannel;
    DWORD  dwFlags; 
    BYTE   bPan;
    BYTE   bVolume;
    short  nTranspose;
    DWORD  dwChannelPriority;
} DMUS_IO_INSTRUMENT;
 

Members

dwPatch

MSB, LSB, and program change to define instrument.

dwAssignPatch

MSB, LSB, and program change to assign to instrument when downloading.

dwNoteRanges

128 bits; one for each MIDI note instrument needs to able to play.

dwPChannel

Performance channel instrument plays on.

dwFlags

Control flags. The following values are defined:

DMUS_IO_INST_ASSIGN_PATCH

dwAssignPatch is valid.

DMUS_IO_INST_BANKSELECT

dwPatch contains a valid bank select, both MSB and LSB.

DMUS_IO_INST_CHANNEL_PRIORITY

dwChannelPriority is valid.

DMUS_IO_INST_GM

Instrument is from the General MIDI collection.

DMUS_IO_INST_GS

Instrument is from the Roland GS collection.

DMUS_IO_INST_NOTERANGES

dwNoteRanges is valid.

DMUS_IO_INST_PAN

bPan is valid.

DMUS_IO_INST_PATCH

dwPatch is valid.

DMUS_IO_INST_TRANSPOSE

nTranspose is valid.

DMUS_IO_INST_USE_DEFAULT_GM_SET

The default General MIDI instrument set should be downloaded to the port even if the port has GM in hardware. If a MIDI file with the XG or GS reset sysex message is parsed, the bank select messages will be sent whether or not GUID_StandardMIDIFile was commanded on the band. In other words, GUID_StandardMIDIFile is effective only for pure GM files.

DMUS_IO_INST_VOLUME

bVolume is valid.

DMUS_IO_INST_XG

Instrument is from the Yamaha XG collection.

bPan

Pan for instrument.

bVolume

Volume for instrument.

nTranspose

Number of semitones to transpose notes.

dwChannelPriority

Channel priority. For a list of defined values, see IDirectMusicPort::GetChannelPriority.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusicf.h.