Platform SDK: DirectX

IDirectMusicComposer::ComposeTemplateFromShape

IDirectMusicComposer::ComposeTemplateFromShape メソッドは、あらかじめ定義されたシェイプに基づいて新しいテンプレートを作成する。

HRESULT ComposeTemplateFromShape(
  WORD wNumMeasures,
  WORD wShape,
  BOOL fIntro,
  BOOL fEnd,
  WORD wEndLength, 
  IDirectMusicSegment** ppTemplate
);

パラメータ

wNumMeasures
アレンジするセクション セグメントの長さ。小節単位で指定する。0 より大きい値でなければならない。
wShape
アレンジするセクション セグメントのシェイプ。DMUS_SHAPET_TYPES 列挙型のいずれかの値を指定する。
fIntro
セクション セグメントの導入部をアレンジしたい場合は TRUE。
fEnd
セクション セグメントの終了部をアレンジしたい場合は TRUE。
wEndLength
終了部を作成したい場合は、終了部の長さ。小節単位で指定する。fEnd が TRUE の場合、この値は 0 より大きく、利用できる小節の数以下でなければならない (つまり、導入部では使われない)。「注意」も参照すること。
ppTemp;ate
作成されたセクション セグメントへのポインタを受け取る変数のアドレス。

戻り値

成功すれば 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::ComposeSegmentFromShapeIDirectMusicComposer::ComposeSegmentFromTemplateテンプレートの使い方