Platform SDK: DirectX

DirectMusicPerformance.GetChordmap

DirectMusicPerformance.GetChordmap メソッドは、パフォーマンスの制御セグメントからコード マップを取り出す。

object.GetChordMap(mtTime As Long, _
    mtUntil As Long) As DirectMusicChordMap

パラメータ

object
DirectMusicPerformance オブジェクトを表すオブジェクト式。
mtTime
コード マップが取り出されるタイム。ミュージック タイムで指定する。
mtUntil
コード マップが有効になるミュージック タイム (mtTime からの相対タイム) を受け取る変数。この変数が値 0 を返した場合、コード マップが常に有効になっているか、コード マップが無効になるタイムが不明であることを意味する。「注意」を参照すること。

戻り値

成功すれば DirectMusicChordmap オブジェクトを返す。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DMUS_E_NO_MASTER_CLOCK
DMUS_E_GET_UNSUPPORTED
DMUS_E_NOT_FOUND
DMUS_E_TRACK_NOT_FOUND

注意

通常、プライマリ セグメントは制御セグメントである。ただし、セカンダリ セグメントを演奏するときは、これを制御セグメントとして指定できる。別の制御セグメントが挿入される場合、このメソッドによって返されるオブジェクトは、mtUntil に返されるタイムの前に無効になることがある。

参照

CONST_DMUS_SEGF_FLAGS