パフォーマンスのパラメータ
DirectMusic では、以下の SetParam メソッドのいずれかを使うことで、再生中にパラメータを変更し、トラックのさまざまな動作を制御できる。
- IDirectMusicPerformance8::SetParam は、パフォーマンスの現在の制御セグメント内にある特定のトラックにデータを設定する。制御セグメントは通常はプライマリ セグメントであるが、演奏中にセカンダリ セグメントを制御セグメントとして指定できる。「制御セグメント」を参照すること。
- IDirectMusicSegment8::SetParam は、セグメント内の特定のトラックにデータを設定する。
- IDirectMusicTrack8::SetParam および IDirectMusicTrack8::SetParamEx は、インターフェイスによって表されるトラックにデータを設定する。アプリケーションは、通常、個々のトラックに対するインターフェイスを持たない。
IDirectMusicPerformance8::SetGlobalParam メソッドを使えば、パフォーマンス全体に適用される値を設定できる。
GetParam メソッドと GetGlobalParam メソッドは、トラックまたはパフォーマンスの現在の値を取得する。
変更したパラメータを音楽に直ちに反映するには、IDirectMusicPerformance8::Invalidate メソッドを使って、キューからメッセージをフラッシュする。このメソッドにより、すべてのトラックは指定したポイント以降のメッセージを再送信する。
参照