SB AWE32 Developer's Information Pack
PART II DOS Real/Protected Mode API
••
21
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
typedef struct {
SHORT bank_no; /* Slot number being used */
SHORT total_banks; /* Total number of banks */
LONG FAR* banksizes; /* Pointer to a list of bank sizes */
LONG reserved; /* Unused */
char FAR* data; /* Address of buffer of size PACKETSIZE */
char FAR* presets; /* Allocated memory for preset data */
LONG total_patch_ram; /* Total patch ram available */
SHORT no_sample_packets;/* No. of packets of samples to stream */
LONG sample_seek; /* Start file location of sound sample */
LONG preset_seek; /* Address of preset_seek location */
LONG preset_read_size; /* No. of bytes from preset_seek to */
/* read into a buffer */
LONG preset_size; /* Preset actual size */
} SOUND_PACKET;
typedef struct {
SHORT tag; /* Must be 0x100 or 0x101 */
SHORT preset_size; /* Preset table of this size is required */
SHORT no_wave_packets;/* No. of packets of Wave sample */
LONG reserved;
SHORT bank_no; /* Bank number */
char FAR* data; /* Address of packet of size PACKETSIZE */
char FAR* presets; /* Allocated memory for preset data */
LONG sample_size; /* Sample size, i.e. number of samples */
LONG samples_per_sec; /* Samples per second */
SHORT bits_per_sample; /* Bits per sample, 8 or 16 */
SHORT no_channels; /* Number of channels, 1=mono, 2=stereo */
SHORT looping; /* Looping? 0=no, 1=yes */
LONG startloop; /* If looping, these addresses */
LONG endloop;
SHORT release; /* Release time, 0=24ms, 8191=23.78s */
} WAVE_PACKET;
SOUND_PACKET data structure is used in API that involve loading and unloading of SoundFont bank
data objects.
WAVE_PACKET data structure provides WAVE loading functionality on top of SOUND_PACKET data
structure.
awe32TotalPatchRam
WORD
PASCAL
awe32TotalPatchRam(SOUND_PACKET FAR* SP)
Actions
Determine the total amount of RAM on the AWE32. This is not the amount of “unused”
RAM but the total amount of RAM. awe32TotalPatchRam assumes the AWE32 card
has been detected and initialized.
Parameters
SP
Points to the SOUND_PACKET. awe32TotalPatchRam assumes that SP is not
NULL.
Return
If successful, awe32TotalPatchRam returns zero; otherwise, it returns non-zero. The
following fields of SP will filled upon successful return from this API.
Member
Remarks
total_patch_ram
The total amount of RAM on the SB AWE32 card.