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