Platform SDK: DirectX

IDirectMusicStyle::GetMotif

IDirectMusicStyle::GetMotif メソッドは、指定されたモチーフを含むセグメントを作成する。

HRESULT GetMotif(
  WCHAR* pwszName, 
  IDirectMusicSegment** ppSegment
);

パラメータ

pwszName
取り出されるモチーフの名前。
ppSegment
指定されたモチーフを含むセグメントへのポインタを受け取る変数のアドレス。

戻り値

成功すれば S_OK または S_FALSE を返す。

失敗すれば E_POINTER を返す。

注意

このメソッドは、pwszName に一致する名前を持つモチーフをスタイル リストから検索する。モチーフが見つかった場合、モチーフ トラックを含むセグメントが作成される。トラックは、スタイルをトラックの関連スタイル、モチーフをトラックのパターンとして参照する。

指定された名前を持つモチーフが存在しない場合、このメソッドは S_FALSE を返す。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusici.h で宣言。

参照

モチーフの使い方