Microsoft DirectX 8.0 (C++) |
あるセクション セグメントからほかのセクション セグメントへのトランジションをアレンジする。
HRESULT ComposeTransition( IDirectMusicSegment* pFromSeg, IDirectMusicSegment* pToSeg, MUSIC_TIME mtTime, WORD wCommand, DWORD dwFlags, IDirectMusicChordMap* pChordMap, IDirectMusicSegment** ppTransSeg );
成功した場合は S_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
E_INVALIDARG |
E_OUTOFMEMORY |
E_POINTER |
pChordMap の値は NULL でもよい。値が NULL の場合、コード マップ トラックからコード マップを取得する試みが行われる。最初に pToSeg、次に pFromSeg が試される。どのセグメントにもコード マップ トラックが含まれない場合は、mtTime に pFromSeg 内で発生するコードがトランジションのコードとして使われる。
コンポーザは、最初に pFromSeg 内、次に pToSeg 内でテンポを探す。どのセグメントにもテンポ トラックがない場合、トランジション セグメントのテンポはスタイルから取得される。
ヘッダー : dmusici.h で宣言。