Microsoft DirectX 8.0 (C++)

IDirectMusicTrack8::GetParamEx

トラックからデータを、ミュージック タイムまたは基準タイムで取得する。

HRESULT GetParamEx(
  REFGUID rguidType, 
  REFERENCE_TIME rtTime, 
  REFERENCE_TIME* prtNext, 
  void * pParam
  void * pStateData,
  DWORD dwFlags
);

パラメータ

rguidType
取得されるデータ型の識別子への参照 (C++) またはアドレス (C)。「標準トラック パラメータ」を参照すること。
rtTime
データの取得を行うタイム。dwFlags に DMUS_TRACK_PARAMF_CLOCK が設定されていない場合、この値はミュージック タイムで取得される。
prtNext
データが無効になるタイムを受け取る変数のアドレス。この変数が値 0 を返した場合、データが常に有効になっているか、データが無効になるタイムが不明であることを意味する。この情報が不要な場合は、prtNext を NULL に設定してもよい。
pParam
返されるデータの保存用に割り当てられた構造体のアドレス。返されるデータの保存用に割り当てられた構造体のアドレス。この構造体は、rguidType で識別されたデータ型にとって適切な種類とサイズを備えていなければならない。
pStateData
トラック インスタンスの状態データを保持するバッファのアドレス。IDirectMusicTrack8::InitPlay から取得される。
dwFlags
0 または次のフラグを指定する。
DMUS_TRACK_PARAMF_CLOCK
rtTime の値は、クロック タイムで表される。

戻り値

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

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

DMUS_E_NOT_FOUND
DMUS_E_NOT_INIT
DMUS_E_TYPE_DISABLED
DMUS_E_GET_UNSUPPORTED
DMUS_E_TRACK_NO_CLOCKTIME_SUPPORT
E_POINTER

動作環境

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

参照

IDirectMusicTrack8::GetParamIDirectMusicTrack8::SetParamEx