DMUS_INSTRUMENT
DLS ダウンロード チャンク内の音色定義を保持する。
typedef struct {
ULONG ulPatch;
ULONG ulFirstRegionIdx;
ULONG ulGlobalArtIdx;
ULONG ulFirstExtCkIdx;
ULONG ulCopyrightIdx;
ULONG ulFlags;
} DMUS_INSTRUMENT;
メンバ
- ulPatch
- 音色のパッチ番号。
- ulFirstRegionIdx
- 音色内の最初のリージョン チャンク (「DMUS_REGION」を参照) のインデックス。これは常に 1 つのリージョンとすべきであるが、将来のシンセサイザ アーキテクチャとの互換性を考慮して、このメンバの値を 0 にすることも認められる。
- ulGlobalArtIdx
- DMUS_OFFSETTABLE 構造体内にある、音色のグローバル アーティキュレーション チャンク (「DMUS_ARTICULATION」および「DMUS_ARTICULATION2」を参照) のインデックス。この値が 0 の場合、この音色にはグローバル アーティキュレーションがない。
- ulFirstExtCkIdx
- DMUS_OFFSETTABLE 構造体内にある、最初の拡張チャンク (「DMUS_EXTENSIONCHUNK」を参照) のインデックス。DirectMusic が認識していない新しいチャンクを追加するために使用される。この値が 0 の場合、この音色にはサードパーティの拡張が関連付けられていない。
- ulCopyrightIdx
- DMUS_OFFSETTABLE 構造体内にある、オプションの著作権チャンク (「DMUS_COPYRIGHT」を参照) のインデックス。この値が 0 の場合、この音色には著作権情報が関連付けられていない。
- ulFlags
- 音色の追加のフラグ。次のフラグが定義されている。
- DMUS_INSTRUMENT_GM_INSTRUMENT
- この音色は General MIDI 標準の音色である。パッチが重複している場合、GM 音色の優先順位は必ずほかの DLS 音色より低くなる。たとえば、パッチ 0 を指定して GM 音色をダウンロードし、同じくパッチ 0 を指定して GM 以外の音色をダウンロードした場合、再生の際に必ず GM 以外の音色が選択される。
ヘッダー : dmdls.h で宣言。