Platform SDK: DirectX

DirectMusicPerformance.GetCommand

DirectMusicPerformance.GetCommand メソッドは、パフォーマンスの制御セグメントからコマンドを取り出す。コマンドは、指定のタイムに演奏されているパターンのタイプを示す。

object.GetCommand(mtTime As Long, mtUntil As Long) As Byte

パラメータ

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

戻り値

成功すれば、コマンドのタイプを返す。「CONST_DMUS_COMMANDT_TYPES」を参照すること。

エラー コード

失敗すればエラーが発生し、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