Microsoft DirectX 9.0 SDK Update (Summer 2004)

^{DMUS_IO_PARTREF}

The DMUS_IO_PARTREF structure contains information about a part reference. Used in the Style Form.

Syntax

typedef struct _DMUS_IO_PARTREF {
  GUID  guidPartID;
  WORD  wLogicalPartID;
  BYTE  bVariationLockID;
  BYTE  bSubChordLevel;
  BYTE  bPriority;
  BYTE  bRandomVariation; 
  WORD  wPad; 
  DWORD dwPChannel;
} DMUS_IO_PARTREF;

Members

guidPartID

Identifier of the part.

wLogicalPartID

Identifier corresponding to a particular MIDI channel on a port. This member has been superseded by dwPChannel and is no longer used.

bVariationLockID

Variation lock identifier. Parts with the same value in this member always play the same variation. A value of 0 means that the part plays its variations independently of all other parts.

bSubChordLevel

Subchord level that this part wants. See Remarks.

bPriority

Reserved for future use.

bRandomVariation

Can be 0, meaning that matching variations play sequentially, or one of the members of the DMUS_VARIATIONT_TYPES enumeration.

wPad

Padding for alignment; value not used.

dwPChannel

Performance channel of the part.

Remarks

The bSubChordLevel member contains a zero-based index value. At run time, 1 is shifted left by this value to yield a 1-bit value for comparison with the dwLevels member of a DMUS_SUBCHORD structure. Thus, a part with a bSubChordLevel of 0 would be mapped to any subchord that contained 1 in dwLevels.

Requirements

  Header: Declared in dmusicf.h.

See Also

• DirectMusic File Structures

---

© 2004 Microsoft Corporation. All rights reserved.