Platform SDK: DirectX |
IDirectMusicComposer::ComposeTemplateFromShape メソッドは、あらかじめ定義されたシェイプに基づいて新しいテンプレートを作成する。
HRESULT ComposeTemplateFromShape( WORD wNumMeasures, WORD wShape, BOOL fIntro, BOOL fEnd, WORD wEndLength, IDirectMusicSegment** ppTemplate );
成功すれば S_OK を返す。
失敗すれば次のエラー値のいずれかを返す。
E_INVALIDARG |
E_OUTOFMEMORY |
E_POINTER |
wEndLength の値は、IDirectMusicComposer::ComposeSegmentFromTemplate メソッドを使ってこのテンプレートに関連付けられる可能性のある任意のスタイル内で利用できる最長の終了部の長さを超えてはならない。終了部は、セグメントが終わる前の wEndLength の小節で演奏を開始する。終了部が wEndLength の小節の長さより短い場合、音楽は基本グルーブ レベルに戻る。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dmusici.h で宣言。
IDirectMusicComposer::ComposeSegmentFromShape、IDirectMusicComposer::ComposeSegmentFromTemplate、テンプレートの使い方