Microsoft DirectX 8.0 (C++)

IDirectMusicSong8::Compose

DirectX 8.0 では実装されていない。

ソングのソース素材から演奏可能なセグメントを作成する。

HRESULT Compose();

パラメータ

なし。

戻り値

成功した場合は、次のいずれかのコードを返す。

S_OK ソングがアレンジされた。
S_FALSE アレンジするトラックがない。
DMUS_S_GARBAGE_COLLECTED ガベージ コレクション」を参照すること。

失敗した場合は、次のいずれかのエラー値を返す。

DMUS_E_TRACK_NOT_FOUND
E_INVALIDARG
E_POINTER
E_OUTOFMEMORY

注意

このメソッドは、ソングの中からすべてのセグメント内のすべてのアレンジ トラックを検索し、同じ識別子とグループ ビットを持つトラックをマスタ アレンジ トラックにまとめる。次に、マスタ アレンジ トラックから優先順位に従って新しいトラックをアレンジし、これらの新しいトラックを元のトラックに対応するように分割する。そして、分割したアレンジ済みのトラックを、ソングのセグメントの適切な場所に挿入する。

動作環境

  ヘッダー : dmusici.h で宣言。

参照

IDirectMusicSegment8::ComposeIDirectMusicTrack8::Compose