Microsoft DirectX 8.0 (C++) |
スタイル、コード マップ、およびテンプレートから、オリジナルのセグメントを作成する。
HRESULT ComposeSegmentFromTemplate( IDirectMusicStyle* pStyle, IDirectMusicSegment* pTemplate, WORD wActivity, IDirectMusicChordMap* pChordMap, IDirectMusicSegment** ppSegment );
成功した場合は S_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
E_INVALIDARG |
E_POINTER |
pStyle が NULL ではない場合、このスタイルはセグメントのアレンジに使われる。NULL の場合、pTempSeg で指定されたテンプレートから取得したスタイルをセグメントのアレンジに使う。同様に、pChordMap が NULL 以外の場合、コードマップはセグメントのアレンジに使用され、NULL の場合、コードマップはテンプレートから取得される。
pStyle が NULL でテンプレート内にスタイル トラックが存在しない場合や、pChordMap が NULL でコード マップ トラックが存在しない場合、このメソッドは E_INVALIDARG を返す。
セクション セグメントの長さは、渡されたテンプレート セクションの長さと等しくなる。
作成されたセグメントのデフォルトの開始ポイントとループ ポイントは、テンプレート セグメント内の値に関係なく 0 である。
ヘッダー : dmusici.h で宣言。
IDirectMusicComposer8::ComposeSegmentFromShape、IDirectMusicComposer8::ComposeTemplateFromShape、テンプレートの使い方