SB AWE32 Developer's Information Pack
PART II DOS Real/Protected Mode API
••
25
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
Member
Remarks
bank_no
The bank number to be released.
Return
If successful, awe32ReleaseBank returns zero, otherwise, it returns non-zero.
awe32ReleaseAllBanks
WORD
PASCAL
awe32ReleaseAllBanks(SOUND_PACKET FAR* SP)
Action
Call the awe32ReleaseBank for each bank..
Parameters
SP
Points to the SOUND_PACKET data object. SP is not used and is meant as a place-
holder.
Return
If successful, awe32ReleaseAllBanks returns zero; otherwise, it returns non-zero.
awe32WPLoadRequest
WORD
PASCAL
awe32WPLoadRequest(WAVE_PACKET FAR* WP)
Action
Prepare the specified WAVE_PACKET to load wave data (PCM samples) into a
specified bank. The wave data is later load into the bank by calling
awe32WPStreamWave, or awe32WPLoadWave. So the wave data may reside in a
file, memory, or any other place; the client has the responsibility of retrieving the data.
Parameters
WP
Points to the WAVE_PACKET. awe32WPLoadRequest assumes WP is not NULL.
Member
Remarks
bank_no
The bank number into which the wave data will be loaded.
sample_size
Size of wave data in number of samples.
no_channels
The number of channels in the wave data. 1 is mono and 2 is
stereo. Only mono (1) is supported.
bits_per_sample
The number of bits per sample. 8 and 16 bits samples are
supported.
tag
Current version number of WAVE_PACKET. Must be 0x101.
Return
If successful, awe32WPLoadRequest returns zero; otherwise, it returns non-zero. In
addition, values are returned in some fields of WAVE_PACKET object.
Member
Remarks
no_wave_packets
The number of wave packets of PACKETSIZE bytes, each,
that must be passed to awe32WPStreamWave; if it is used.