DMUS_DOWNLOADINFO

The DMUS_DOWNLOADINFO structure is used as a header for DLS data to be downloaded to a port. It defines the size and functionality of the download and is always followed by a DMUS_OFFSETTABLE chunk.

typedef struct _DMUS_DOWNLOADINFO {
    DWORD dwDLType;
    DWORD dwDLId;
    DWORD dwNumOffsetTableEntries;
    DWORD cbSize;
} DMUS_DOWNLOADINFO;
 

Members

dwDLType

Type of data being downloaded. The following types are defined:

DMUS_DOWNLOADINFO_INSTRUMENT

Instrument definition, starting with the DMUS_INSTRUMENT structure

DMUS_DOWNLOADINFO_WAVE

PCM wave data, starting with the DMUS_WAVE structure.

dwDLId

Unique 32-bit identifier for the object. See Remarks.

dwNumOffsetTableEntries

Number of entries in the DMUS_OFFSETTABLE structure that follows.

cbSize

Size of this memory chunk, inlcuding the offset table.

Remarks

The identifier in dwDLId is used to connect objects together and is obtained by using the IDirectMusicPortDownload::GetDLId method. Primarily it connects the regions in an instrument to wave chunks. For example, suppose a wave download is given a dwDLId of 3. Then an instrument chunk downloads with the value 3 placed in the WaveLink.ulTableIndex member of one of its DMUS_REGION structures. This indicates that the region is connected to the wave chunk.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmdls.h.

See Also

Low-Level DLS