Platform SDK: DirectX |
DirectMusicPerformance および DirectMusicSegment のメソッドのいくつかでは、通常は制御セグメントの特定のトラックでパラメータを設定または取得することができる。ただし、DirectX for Visual Basic を使用するアプリケーションは、これらのトラックについて関与する必要はない。これらのメソッドは、低レベルでの動作について知らなくても使用することができる。
パフォーマンス、セグメント、またはトラックの SetParam および GetParam メソッドを使って、トラック パラメータを設定および取得することができる。パフォーマンスまたはセグメントでこれらのメソッドのいずれかを呼び出すときに、dwGroupBits および dwIndex パラメータを設定して、トラックを識別することができる。ただし、ほとんどの場合は、DirectMusic に適切なトラックを検索させることができる。詳細については、「トラックの識別」を参照すること。
場合によっては、変更を行うタイム、またはパラメータを取得するタイムを、トラック内で指定しなければならない。特定のトラック パラメータでこの値が使用されているかどうかを確認するには、「トラック パラメータのタイプ」を参照すること。
いくつかのパラメータでは、SetParam で機能がオンまたはオフになり、データは必要ない。ただし、ほかのパラメータを設定するときに、データを含む構造体または変数も渡さなければならない。データに関連付けられたパラメータだけを取り出すことができる。したがって、GetParam を使う場合、データを受け取るには、常に適切な変数または構造体へのポインタを渡さなければならない。
特定のパラメータがトラックによってサポートされているかどうかを確認するには、IDirectMusicTrack::IsParamSupported メソッドを使用して、S_OK の結果を確認する。
詳細については、次のトピックを参照すること。