Microsoft DirectX 8.0 (C++)

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_INSTRUMENT2
DMUS_INSTRUMENT 構造体から始まる、DLS レベル 2 アーティキュレーションをサポートする音色の定義。
DMUS_DOWNLOADINFO_WAVE
DMUS_WAVE 構造体から始まる PCM ウェーブのデータ。
dwDLId
オブジェクトの一意の 32 ビット識別子。「注意」を参照すること。
dwNumOffsetTableEntries
後に続く DMUS_OFFSETTABLE 構造体内のエントリの数。
cbSize
DMUS_DOWNLOADINFODMUS_OFFSETTABLE、および実際のデータ チャンクの合計サイズ。

注意

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

動作環境

  ヘッダー : dmdls.h で宣言。

参照

下位レベル DLS