Platform SDK: DirectX |
DirectMusic のアレンジをプログラミングする場合、DirectMusic Producer のようなツールで作成したさまざまなファイルを使う。これらの要素を COM オブジェクトとしてアプリケーションにロードし、それらのオブジェクトへのインターフェイスを取得する (「DirectMusic ローダー」を参照すること)。
次の表に、開発者が扱うファイルのタイプを示す。
クラス 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 |
要素 | DirectMusicLoader メソッド | クラス | ファイル タイプ |
---|---|---|---|
バンド | LoadBand | DirectMusicBand | .bnd |
DLS コレクション | LoadCollection | DirectMusicCollection | .dls |
コード マップ | LoadChordMap | DirectMusicChordMap | .cdm |
セグメント | LoadSegment | DirectMusicSegment | .sgt |
スタイル | LoadStyle | DirectMusicStyle | .sty |
テンプレート | LoadSegment | DirectMusicSegment | .tpl |
注 : バンドはスタイルの一部としてオーサリングできるが、その場合、スタイルをロードするときにそれらも自動的にロードされる。同様に、スタイルとバンドはセグメントにオーサリングできる。この場合、これらの要素を別のファイルに分ける必要ない。
ファイルには、ほかのファイルへの参照を含めることができる。スタイルにバンドへの参照が含まれている場合、ローダーがバンド ファイルを見つけることができれば、スタイルがロードされるときに自動的にバンドもロードされる。