Microsoft DirectX 8.0 (C++)

IDirectMusicPatternTrack8::SetPatternByName

トラックで再生されるパターンを設定する。パターンはスタイルから取得する。

HRESULT SetPatternByName(
  IDirectMusicSegmentState* pSegState,
  WCHAR* wszName,
  IDirectMusicStyle* pStyle,
  DWORD dwPatternType,
  DWORD* pdwLength
);

パラメータ

pSegState
トラックを再生しているセグメント状態の IDirectMusicSegmentState8 インターフェイスのアドレス。
wszName
設定するパターンの名前。名前は IDirectMusicStyle8::EnumPattern を使って取得できる。
pStyle
パターンを保持するスタイルの IDirectMusicStyle または IDirectMusicStyle8 インターフェイスのアドレス。
dwPatternType
パターンのタイプを指定する DMUS_STYLET_TYPES 列挙の 1 つ。
pdwLength
パターンの長さ (ミュージック タイムのティック単位) を受け取る変数のアドレス。

戻り値

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

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

DMUS_E_NOT_FOUND
DMUS_E_NOT_INIT
E_OUTOFMEMORY
E_POINTER

動作環境

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