SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
55
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
Specify a word data type. This word contains the UBank Index indicating
which User Bank to be removed from memory. Valid range is 1 to 127.
l
Param2
Unused.
hUserID
Current ID assigned to the application by the AWE Manager during
initialization.
Remarks
None.
Return
The return value will be AWE_NO_ERR if the operation is successful, and
an error code otherwise. Possible errors are:
AWE_ERR_USERID_INVALID
AWE_ERR_DEVICE_BUSY
AWE_ERR_UBANK_INVALID
See Also
AWE_LOAD_USER_BANK, AWE_CLEAR_USER_BANK
AWE_LOAD_WAVEFX
Actions
An application sends this message to inform the AWE Manager that it wishes
to load a wave file as an instrument into either Synthesizer Bank or User
Bank. The acceptable files can be any Windows acceptable PCM wave
files. Compressed wave files are not supported.
Parameters
lParam1
Specify a word data type. High word of lParam1 should be set to the Bank
Number and low word should be set to the Instrument Number. The valid
range of Bank Numbers is 0 to 127. Conventionally, Synthesizer Bank will
occupy Bank 0 and User Bank will occupy Bank 1 to 127.
Note : By default, the driver will remember any WaveFXs that are loaded
using this message. Driver will reload the WaveFXs after system reboot
unless the high bit of the Bank number is set when sending this message.
lParam2
Specify a far pointer to CBufferObject, LPBUFFEROBJECT. When the
application calls the manager, the following fields are used:
Member
Remarks
m_Flag
Set to 0
m_Buffer
Far pointer to a buffer area that contain the full path
to the wave file to be loaded as WaveFX
hUserID
Current ID assigned to the application by the AWE Manager during
initialization.
Remarks
The following are some important points to note when using this function.