Microsoft DirectX 8.0 (C++)

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 で宣言。