Platform SDK: DirectX

DMUS_DOWNLOADINFO

DMUS_DOWNLOADINFO 構造体は、ポートにダウンロードされる DLS データのヘッダーとして使われる。この構造体はダウンロードのサイズと機能を定義し、その後には常に DMUS_OFFSETTABLE チャンクが続く。

typedef struct _DMUS_DOWNLOADINFO {
    DWORD dwDLType;
    DWORD dwDLId;
    DWORD dwNumOffsetTableEntries;
    DWORD cbSize;
} DMUS_DOWNLOADINFO;
dwDLType
ダウンロードされるデータ タイプ。次のタイプが定義されている。
DMUS_DOWNLOADINFO_INSTRUMENT
DMUS_INSTRUMENT 構造体から始まる楽器の定義。
DMUS_DOWNLOADINFO_WAVE
DMUS_WAVE 構造体から始まる PCM ウェーブのデータ。
dwDLId
オブジェクトの一意の 32 ビット識別子。「注意」を参照すること。
dwNumOffsetTableEntries
後に続く DMUS_OFFSETTABLE 構造体内のエントリの数。
cbSize
DMUS_DOWNLOADINFODMUS_OFFSETTABLE、および実際のデータ チャンクの合計サイズ。

注意

dwDLId 内の識別子は、オブジェクトを接続するために使われ、IDirectMusicPortDownload::GetDLId メソッドを使って取得される。主に、楽器内のリージョンをウェーブ チャンクに結合する。たとえば、ウェーブ ダウンロードに 3 の dwDLId を指定した場合、音色チャンクは、いずれかの DMUS_REGION 構造体の WaveLink.ulTableIndex メンバに値 3 を配置された形でダウンロードされる。これは、リージョンがウェーブ チャンクに接続されていることを示す。

動作環境

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

参照

下位レベル DLS