Platform SDK: DirectX

IDirectMusicTrack::GetParam

IDirectMusicTrack::GetParam メソッドは、トラックからデータを取り出す。

HRESULT GetParam(
  REFGUID rguidType, 
  MUSIC_TIME mtTime, 
  MUSIC_TIME* pmtNext,
  void* pParam
);

パラメータ

rguidType
取得されるデータ タイプの識別子への参照 (C++) またはアドレス (C)。「トラック パラメータのタイプ」を参照すること。
mtTime
データを取得するタイム。トラック時間で指定する。
pmtNext
データが有効になるタイムを受け取る変数のアドレス。この変数が値 0 を返した場合、データが常に有効になっているか、データが無効になるタイムが不明であることを意味する。この情報が不要な場合は、pmtNext を NULL に設定してもよい。
pParam
返されるデータの保存用に割り当てられた構造体のアドレス。返されるデータの保存用に割り当てられた構造体のアドレス。この構造体は、rguidType で識別されたデータ タイプにとって適切な種類とサイズを備えていなければならない。

戻り値

成功すれば S_OK を返す。

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

DMUS_E_NOT_FOUND
DMUS_E_NOT_INIT
DMUS_E_TYPE_DISABLED
DMUS_E_GET_UNSUPPORTED
E_POINTER

動作環境

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

参照

IDirectMusicTrack::SetParamIDirectMusicTrack::IsParamSupportedIDirectMusicPerformance::GetParamIDirectMusicSegment::GetParamミュージック パラメータ