SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
52
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
"MT 32"
2
MT
SYNTHMT.SBK
"User Custom Synth"
3
USER
SYNTHUSR.SBK
For Windows 3.1x, the bank files can be located in the default directory of
AWE. This default directory is usually a sub-directory of the Sound Blaster
path. The Sound Blaster path is located from the environment variable
"
SOUND
". The default name is used whenever a user specified file cannot be
located. The path specified by the user can be found in the
SBWIN.INI
file
under the "AWE32" section. The entry name for each respective synthesizer
emulation is listed in the table. Hence,
[AWE32]
GM = C:\SBANK\USER1.SBK
will have an assignment of
USER1.SBK
file as the General MIDI Bank.
For Windows 95 and Windows NT, the path names for bank files are located
in the Registry. If the specified path is not found, the driver will look for the
file in Windows’ SYSTEM directory.
lParam2
Unused.
hUserID
Current ID assigned to the application by the AWE Manager during
initialization.
Remarks
This function does not allow an application to specify a file name and
overwrite the original Synthesizer Bank instrument files. The AWE Manager
uses a predetermined name which is known to both the MIDI driver and
itself. To use a user-define emulation as Synthesizer Bank, copy it to the
default AWE directory and rename it to
SYNTHUSR.SBK
.
Return
The return value would 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_SBANK_INVALID
AWE_ERR_PATHNAME_INVALID
AWE_ERR_SYSMEM_INSUFFICIENT
AWE_ERR_DRAM_INSUFFICIENT
See Also
AWE_QUERY_SYN_SUPPORT, AWE_GET_SYN_BANK
AWE_LOAD_USER_BANK
Actions
An application sends this message to inform the AWE Manager that it wishes
to load a bank of instruments into the User Bank area. The source can be
either in a file or in memory blocks.
Parameters
lParam1