Platform SDK: DirectX

IDirectMusicInstrument

IDirectMusicInstrument インターフェイスは、DLS コレクションの個別の音色を表す。

DirectMusicInstrument オブジェクトを作成して、音色をダウンロードするための唯一の方法は、最初に DirectMusicCollection オブジェクトを作成し、次に IDirectMusicCollection::GetInstrument メソッドを呼び出す。GetInstrument は DirectMusicInstrument オブジェクトを作成し、IDirectMusicInstrument インターフェイス ポインタを返す。

音色をダウンロードするには、その音色のインターフェイス ポインタを IDirectMusicPort::DownloadInstrument メソッドまたは IDirectMusicPerformance::DownloadInstrument メソッドに渡す。このメソッドが成功すると、IDirectMusicDownloadedInstrument インターフェイスへのポインタが返される。このインターフェイスは、楽器をアンロードする場合にのみ使われる。

IDirectMusicInstrument のメソッドは、既にダウンロードされている音色のみに対して動作する。既にポートにダウンロードされた楽器のインスタンスは、IDirectMusicInstrument::GetPatchIDirectMusicInstrument::SetPatch の各メソッドの影響を受けない。

このインターフェイスは、以下のメソッドをサポートする。

IDirectMusicInstrument GetPatch
  SetPatch

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

IUnknown AddRef
  QueryInterface
Release

動作環境

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