Microsoft DirectX 8.0 (C++)

IDirectMusicComposer8::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 より大きく、利用できる小節の数以下でなければならない (つまり、イントロでは使われない)。「注意」も参照すること。
ppTemplate
作成されたセクション セグメントへのポインタを受け取る変数のアドレス。

戻り値

成功した場合は S_OK を返す。

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

E_INVALIDARG
E_OUTOFMEMORY
E_POINTER

注意

wEndLength の値は、IDirectMusicComposer8::ComposeSegmentFromTemplate メソッドを使ってこのテンプレートに関連付けられる可能性のある任意のスタイル内で利用できる、最長のエンディングの長さを超えてはならない。エンディングは、セグメントが終わる前の wEndLength の小節で演奏を開始する。エンディングが wEndLength の小節の長さより短い場合、音楽は基本グルーブ レベルに戻る。

動作環境

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

参照

IDirectMusicComposer8::ComposeSegmentFromTemplateテンプレートの使い方