SB AWE32 Developer's Information Pack
PART II DOS Real/Protected Mode API
••
26
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
preset_size
The number of bytes required by the library for presets for the
bank. Allocate this much memory for this purpose.
awe32WPLoadWave
WORD
PASCAL
awe32WPLoadWave(WAVE_PACKET FAR* WP)
Action
Load all of the wave data into a bank. Use this function instead of repeatedly calling
awe32WPStreamWave when all the sound data can fit in a single block of memory.
(In Real mode, the sound data must be less than 64 KB long.)
Parameters
WP
Points to the WAVE_PACKET. awe32WPLoadWave assumes WP is not NULL.
Member
Remarks
data
Points to the sample data.
bits_per_sample
The wave data resolution (number of bits per sample) of the
sample object. This should have the same value as it did when
awe32WPLoadRequest was called.
Return
If successful, awe32WPLoadWave returns zero; otherwise, it returns non-zero.
awe32WPStreamWave
WORD
PASCAL
awe32WPStreamWave(WAVE_PACKET FAR* WP)
Action
Load one packet of wave data into the specified bank.
Parameters
WP
Points to the WAVE_PACKET. awe32WPStreamWave assumes WP is not NULL.
The fields in the WAVE_PACKET should have the same values they did when
previous call to awe32WPLoadRequest returned.
Member
Remarks
bank_no
The bank number to which the wave data will be loaded.
data
Points to the wave data buffer of PACKETSIZE bytes.
bits_per_sample
The wave data resolution (number of bits per sample) of the
sample object. This should have the same value as it did when
awe32WPLoadRequest was called.
Return
If successful, awe32WPStreamWave returns zero; otherwise, it returns non-zero.