Platform SDK: DirectX

IDirectMusicPerformance::SetParam

IDirectMusicPerformance::SetParam メソッドは、制御セグメント内のトラック上にデータを設定する。

HRESULT SetParam(
  REFGUID rguidType,
  DWORD dwGroupBits,
  DWORD dwIndex,
  MUSIC_TIME mtTime,
  void* pParam
);

パラメータ

rguidType
設定されるデータ タイプの識別子への参照 (C++) またはアドレス (C)。「トラック パラメータのタイプ」を参照すること。
dwGroupBits
希望のトラックが置かれるグループ。
dwIndex
データの設定に使われる、dwGroupBits で識別されたグループ内で、トラックに割り当てられているインデックス。
mtTime
データの設定を行うタイム。IDirectMusicSegment::SetParam とは異なり、このメソッドではパフォーマンス タイムを使ってこのタイムを表す。このタイムからセグメントの開始タイムを引き、その結果を IDirectMusicSegment::GetParam に渡す。
pParam
データを保持する構造体のアドレス。この構造体は、rguidType で識別されたデータ タイプにとって適切な種類とサイズを備えていなければならない。

戻り値

成功すれば S_OK を返す。

失敗すれば次のエラー値のいずれかを返す。

DMUS_E_NO_MASTER_CLOCK
DMUS_E_SET_UNSUPPORTED
DMUS_E_TRACK_NOT_FOUND
E_POINTER

注意

通常、プライマリ セグメントは制御セグメントである。ただし、セカンダリ セグメントを演奏するときは、これを制御セグメントとして指定できる。DMUS_SEGF_FLAGS を参照すること。

dwGroupBitsdwIndex の説明については、「トラックの識別」を参照すること。

動作環境

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

参照

IDirectMusicPerformance::GetParamIDirectMusicPerformance::SetGlobalParamIDirectMusicSegment::SetParamIDirectMusicTrack::SetParamIDirectMusicPerformance::GetTimeミュージック パラメータ