Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::SetParam

制御セグメントのトラックにデータを設定する。

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

パラメータ

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

戻り値

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

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

DMUS_E_NO_MASTER_CLOCK
DMUS_E_SET_UNSUPPORTED
DMUS_E_TRACK_NOT_FOUND
E_POINTER

注意

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

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

動作環境

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

参照

IDirectMusicPerformance8::GetParamIDirectMusicPerformance8::SetGlobalParamIDirectMusicSegment8::SetParamIDirectMusicTrack8::SetParamExIDirectMusicPerformance8::GetTimeパフォーマンス パラメータ