Platform SDK: DirectX

パフォーマンス クラス

[C++]

ここでは、Visual Basic でのアプリケーション開発について説明する。C++ については、「DirectMusic オブジェクトとインターフェイスの概要」を参照すること。

[Visual Basic]

DirectMusicPerformance クラスは、DirectMusic アプリケーションの中心である。ほとんどのアプリケーションは、このクラスのオブジェクトを 1 つ持ち、タイミングとポートの管理、マスタ テンポなどのグローバル ミュージック パラメータの変更、およびミュージック セグメントの演奏を行う。

MIDI ファイルや、DirectMusic Producer などのアプリケーションでオーサリングされたセグメントなど、音楽の部品はそれぞれ DirectMusicSegment クラスのオブジェクトによって表される。このクラスのメソッドを使うと、セグメントのミュージック パラメータを設定または取り出したり、関連付けられている DLS 音色を管理することができる。DirectMusicSegment の特殊な形態であるテンプレートは、演奏可能なセグメントのリアルタイム アレンジに使用される。

DirectMusicSegment オブジェクトを DirectMusicPerformance.PlaySegment に渡すときに、メソッドは、セグメントの演奏中のインスタンスを表す DirectMusicSegmentState クラスのオブジェクトを返す。このオブジェクトのメソッドを使うと、演奏が開始されたタイムなどの情報を取得できる。DirectMusicSegmentState は、セグメントが現在演奏中であるかどうかを判定したり、再生を停止するために、DirectMusicPerformance にも渡される。