Platform SDK: DirectX |
IDirectMusicInstrument インターフェイスは、DLS コレクションの個別の音色を表す。
DirectMusicInstrument オブジェクトを作成して、音色をダウンロードするための唯一の方法は、最初に DirectMusicCollection オブジェクトを作成し、次に IDirectMusicCollection::GetInstrument メソッドを呼び出す。GetInstrument は DirectMusicInstrument オブジェクトを作成し、IDirectMusicInstrument インターフェイス ポインタを返す。
音色をダウンロードするには、その音色のインターフェイス ポインタを IDirectMusicPort::DownloadInstrument メソッドまたは IDirectMusicPerformance::DownloadInstrument メソッドに渡す。このメソッドが成功すると、IDirectMusicDownloadedInstrument インターフェイスへのポインタが返される。このインターフェイスは、楽器をアンロードする場合にのみ使われる。
IDirectMusicInstrument のメソッドは、既にダウンロードされている音色のみに対して動作する。既にポートにダウンロードされた楽器のインスタンスは、IDirectMusicInstrument::GetPatch や IDirectMusicInstrument::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 で宣言。