Microsoft DirectX 8.0 (C++)

IDirectMusicInstrument8

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 で宣言。