Microsoft DirectX 8.0 (C++) |
IDirectMusicInstrument8 インターフェイスは、DLS コレクションの個別の音色を表す。
IDirectMusicInstrument8 は、IDirectMusicInstrument の型定義である。2 つのインターフェイス名は入れ替え可能である。
DirectMusicInstrument オブジェクトを作成して、音色をダウンロードするための唯一の方法は、最初に DirectMusicCollection オブジェクトを作成し、次に IDirectMusicCollection8::GetInstrument メソッドを呼び出すことである。GetInstrument は DirectMusicInstrument オブジェクトを作成し、IDirectMusicInstrument8 インターフェイス ポインタを返す。
音色をダウンロードするには、そのインターフェイス ポインタを IDirectMusicPort8::DownloadInstrument メソッドまたは IDirectMusicPerformance8::DownloadInstrument メソッドに渡す。このメソッドが成功すると、IDirectMusicDownloadedInstrument8 インターフェイスへのポインタが返される。このインターフェイスは、音色をアンロードする場合にのみ使われる。
IDirectMusicInstrument8 のメソッドは、既にダウンロードされている音色のみに対して動作する。ポートにダウンロードされた音色のインスタンスは、IDirectMusicInstrument8::GetPatch メソッドや IDirectMusicInstrument8::SetPatch メソッドによる影響は受けない。
このインターフェイスは、以下のメソッドをサポートする。
IDirectMusicInstrument8 | GetPatch |
SetPatch |
すべての COM インターフェイスは IUnknown インターフェイスのメソッドを継承する。IUnknown インターフェイスは、以下の 3 つのメソッドをサポートする。
IUnknown | AddRef |
QueryInterface | |
Release |
LPDIRECTMUSICINTRUMENT8 型は、このインターフェイスへのポインタとして定義されている。
typedef IDirectMusicInstrument8 *LPDIRECTMUSICINSTRUMENT8;
ヘッダー : dmusicc.h で宣言。