IDirectMusicSegment8::GetParam
このセグメント内部のトラックからデータを取得する。
HRESULT GetParam(
REFGUID rguidType,
DWORD dwGroupBits,
DWORD dwIndex,
MUSIC_TIME mtTime,
MUSIC_TIME* pmtNext,
void* pParam
);
パラメータ
- rguidType
- 取得されるデータ型の識別子への参照 (C++) またはアドレス (C)。「標準トラック パラメータ」を参照すること。
- dwGroupBits
- 希望のトラックが置かれているグループ。すべてのグループを指定するには、この値を 0xFFFFFFFF に設定する。詳細については、「トラックの識別」を参照すること。
- dwIndex
- データを取得する元となる、dwGroupBits で識別されるグループ内のトラックのインデックス。パラメータを保持する最初のトラックを見つけるには、DMUS_SEG_ANYTRACK を指定する。
- mtTime
- データの取得を行うタイム。
- pmtNext
- データが無効になるセグメント タイム (mtTime からの相対タイム) を受け取る変数のアドレス。この変数が値 0 を返した場合、データが常に有効になっているか、データが無効になるタイムが不明であることを意味する。この情報が不要な場合は、pmtNext を NULL に設定してもよい。「注意」を参照すること。
- pParam
- 返されるデータの保存用に割り当てられた構造体のアドレス。返されるデータの保存用に割り当てられた構造体のアドレス。この構造体は、rguidType で識別されたデータ型にとって適切な種類とサイズを備えていなければならない。
戻り値
成功した場合は S_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
注意
別の制御セグメントが挿入される場合、*pmtNext で返されるタイムの前にデータが無効になることがある。詳細については、「制御セグメント」を参照すること。
ヘッダー : dmusici.h で宣言。
参照
IDirectMusicPerformance8::GetParam、IDirectMusicSegment8::SetParam、IDirectMusicTrack8::GetParamEx、パフォーマンス パラメータ