Platform SDK: DirectX

IDirectMusicPerformance

IDirectMusicPerformance インターフェイスは、音楽再生の総合的なマネージャである。このインターフェイスは、ポートの追加と削除、パフォーマンス チャンネルのポートへのマッピング、セグメントの演奏、ツールによるメッセージの発信とルーティング、イベント通知の要求と受け取り、およびミュージック パラメータの設定と取り出しに使用される。また、タイミングに関する情報の取得、およびシステム間でタイムとミュージック値を変換するためのメソッドも備えている。

アプリケーションが 2 つの完全なミュージック セットを同時に演奏したい場合、複数のパフォーマンスを作成することにより、そのような演奏が行える。個別のパフォーマンスは独立したテンポマップに従い、完全に非同期に演奏されるが、一方で 1 つのパフォーマンス内のすべてのセグメントは固定的なステップで演奏される。

IDirectMusicPerformance インターフェイスのメソッドは、以下のグループにまとめることができる。

チャンネル AssignPChannel
  AssignPChannelBlock
PChannelInfo
楽器 DownloadInstrument
メッセージ AllocPMsg
  FreePMsg
SendPMsg
MIDI 変換 MIDIToMusic
  MusicToMIDI
通知 AddNotificationType
  GetNotificationPMsg
RemoveNotificationType
SetNotificationHandle
パラメータ GetGlobalParam
  GetParam
SetGlobalParam
SetParam
ポート AddPort
  RemovePort
セグメント GetSegmentState
  IsPlaying
PlaySegment
Stop
タイミング AdjustTime
  GetBumperLength
GetLatencyTime
GetPrepareTime
GetQueueTime
GetResolvedTime
GetTime
MusicToReferenceTime
ReferenceToMusicTime
RhythmToTime
SetBumperLength
SetPrepareTime
TimeToRhythm
ツール GetGraph
  SetGraph
その他 CloseDown
  Init
Invalidate

すべての COM インターフェイスは、IUnknown インターフェイス メソッドを継承する。IUnknown インターフェイスは、以下の 3 つのメソッドをサポートする。

IUnknown AddRef
  QueryInterface
Release

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusici.h で宣言。