Microsoft DirectX 8.0 (C++)

DMUS_BAND_PARAM

トラックがバンド トラックであり、rguidTypeGUID_BandParam である場合、各種のパラメータ取得メソッドやパラメータ設定メソッドを呼び出す際に、pParam パラメータとして使用される。

typedef struct _DMUS_BAND_PARAM {
    MUSIC_TIME mtTimePhysical;
    IDirectMusicBand *pBand;
} DMUS_BAND_PARAM;

メンバ

mtTimePhysical
バンド チェンジが発生する実際のタイム。「注意」を参照すること。
pBand
バンドの IDirectMusicBand8 インターフェイスのアドレス。

注意

mtTimePhysical の値は、バンド チェンジが発生する実際のタイムである。一方、パラメータ設定メソッドの mtTime パラメータの値は、拍や小節と同期した、バンド チェンジが属するパフォーマンス内のポイントである。mtTimePhysical に対して、mtTime より少し早いタイムを設定することで、バンド チェンジがループの先頭に発生する場合にも、ノートが常に正しいバンドによって演奏されることが保証される。

クロック タイム トラックの場合、mtTimePhysical はそのトラックの内部時間フォーマットで解釈される。これは、再生開始からのミリ秒数である。これは紛らわしいため、クロック タイム トラックでは GUID_BandParam を使用しないことが推奨される。

動作環境

  ヘッダー : dmusicf.h で宣言。

参照

IDirectMusicPerformance8::GetParamIDirectMusicPerformance8::SetParamIDirectMusicSegment8::GetParamIDirectMusicSegment8::SetParamIDirectMusicTrack8::GetParamExIDirectMusicTrack8::SetParamExパフォーマンス パラメータ