Creative AWE32 - Real and Protected Mode API Programming Guide

SB AWE32 Developer's Information Pack PART II DOS Real/Protected Mode API •• 27
Copyright  Creative Technology Ltd., 1994-1996 Version 3.00
awe32WPBuildSFont
WORD
PASCAL
awe32WBuildSFont(WAVE_PACKET FAR* WP)
Action
Construct a SoundFont preset object for the download wave data. In effect the wave
data becomes an instrument in the specified bank.
Parameters
WP
Points to the WAVE_PACKET. awe32WPBuildSFont assumes WP is not NULL.
Member Remarks
bank_no
The bank number into which the wave data will be loaded.
tag
Current version number of WAVE_PACKET. This value must
be the same value that was present when
awe32WPLoadRequest
and
awe32WPStreamWave
were
called.
sample_size
Holds the number of samples in the sample object. This must
be the same value that was present when
awe32WPLoadRequest
and
awe32WPStreamWave
were
called.
samples_per_sec
Holds the frequency of the wave data. Supported frequencies
are 8000Hz, 11025Hz, 22050Hz, and 44100Hz.
looping
Holds zero if there is no loop in the sample. Otherwise, holds
non-zero and the start and end of the loop as offsets into the
WAVE data are specified in
WP->startloop
and
WP-
>endloop
, respectively.
release
Specify the duration of the release section of the sample. Zero
causes a release duration of 24 milliseconds; 5940, 23.78
seconds. Values higher than 5940 are treated as 5940.
presets
Points to a block of memory the library may use for holding
presets. The block of memory must be at least
WP-
>preset_size
bytes in length. (This length was obtained by
calling
awe32WPLoadRequest
).
Return
If successful, awe32WPBuildSFont returns zero; otherwise, it returns non-zero.
Real and Protected Mode API Programming Guide
This chapter gives a general guide in using the DOS Real and Protected mode API. This chapter consists
of 10 sections:
• Using the libraries
• Initialization
• Termination
• Using embedded GM presets
• Loading a SoundFont Bank