Microsoft DirectX 8.0 (C++)

トラック パラメータの設定と取得

トラック パラメータを設定および取得するために、以下のメソッドが使用される。

パフォーマンスまたはセグメントでこれらのメソッドのいずれかを呼び出すときに、dwGroupBits および dwIndex パラメータを設定して、トラックを識別することができる。ただし、通常は、DirectMusic に適切なトラックを検索させることができる。詳細については、「トラックの識別」を参照すること。

設定または取得するトラック パラメータは、メソッドの rguidType パラメータにある GUID で識別される。データを必要とする各パラメータは、特定のデータ型に関連付けられている。pParam は、この型の変数または構造体を指していなければならない。場合によっては、パラメータを取得するときにも、データ構造体の一部を初期化する必要がある。また、パラメータによっては、変更を行うタイム、またはパラメータを取得するタイムをトラック内で指定しなければならない。

標準的なパラメータ タイプに関連するデータのリファレンス情報については、「標準トラック パラメータ」を参照すること。

一部のパラメータの変更は、直ちに有効にならないように見える。たとえば、グルーブ レベルの変更は、現在のパターンの演奏が終了し、次のパターンを選択するまで変化がない。この変更を直ちに有効にするには、IDirectMusicPerformance8::Invalidate メソッドを呼び出して、現在のパターンを強制的に破棄することができる。

特定のパラメータがトラックによってサポートされているかどうかを確認するには、IDirectMusicTrack8::IsParamSupported メソッドを使用して、S_OK の結果を確認する。

詳細については、次のトピックを参照すること。