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.