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 を返す。
失敗した場合は、次のいずれかのエラー値を返す。
ヘッダー : dmplugin.h で宣言。
参照
IDirectMusicTrack8::GetParam、IDirectMusicTrack8::SetParamEx