Platform SDK: DirectX

アレンジ用のミュージック ファイル

DirectMusic のアレンジをプログラミングする場合、DirectMusic Producer のようなツールで作成したさまざまなファイルを使う。これらの要素を COM オブジェクトとしてアプリケーションにロードし、それらのオブジェクトへのインターフェイスを取得する (「DirectMusic ローダー」を参照すること)。

次の表に、開発者が扱うファイルのタイプを示す。

[C++]

クラス GUID は、オブジェクトをロードする際に DMUS_OBJECTDESC 構造体の guidClass メンバに書き込む値である。

要素 クラス GUID インターフェイス ファイル タイプ
バンド CLSID_DirectMusicBand IDirectMusicBand .bnd
DLS コレクション CLSID_DirectMusicCollection IDirectMusicCollection .dls
コード マップ CLSID_DirectMusicChordMap IDirectMusicChordMap .cdm
セグメント CLSID_DirectMusicSegment IDirectMusicSegment .sgt
スタイル CLSID_DirectMusicStyle IDirectMusicStyle .sty
テンプレート CLSID_DirectMusicSegment IDirectMusicSegment .tpl

[Visual Basic]
要素 DirectMusicLoader メソッド クラス ファイル タイプ
バンド LoadBand DirectMusicBand .bnd
DLS コレクション LoadCollection DirectMusicCollection .dls
コード マップ LoadChordMap DirectMusicChordMap .cdm
セグメント LoadSegment DirectMusicSegment .sgt
スタイル LoadStyle DirectMusicStyle .sty
テンプレート LoadSegment DirectMusicSegment .tpl

 :  バンドはスタイルの一部としてオーサリングできるが、その場合、スタイルをロードするときにそれらも自動的にロードされる。同様に、スタイルとバンドはセグメントにオーサリングできる。この場合、これらの要素を別のファイルに分ける必要ない。

ファイルには、ほかのファイルへの参照を含めることができる。スタイルにバンドへの参照が含まれている場合、ローダーがバンド ファイルを見つけることができれば、スタイルがロードされるときに自動的にバンドもロードされる。