SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
50
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
String
Idx
Entry
File
"General MIDI
0
GM
SYNTHGM.SBK
"GS"
1
GS
SYNTHGS.SBK
"MT 32"
2
MT
SYNTHMT.SBK
"User Custom Synth" 3
USER
SYNTHUSR.SBK
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 can be 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
"AWE32" section. The entry name for each respective synthesizer emulation
are listed in the table. Hence,
[AWE32]
GM = C:\SBANK\USER1.SBK
will have an assignment of
USER1.SBK
file as the General MIDI Bank.
lParam2
Unused.
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.
The location passed in as pointer must be valid memory locations allocated
by the parent application. If the locations are invalid, it is possible to trip
General Protection Fault in Windows
If the buffer is not sufficient to complete the operation, AWE Manager will
not update string entries into the buffer. However, other return parameters
will still be updated.
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_RESOURCE_INSUFFICIENT
AWE_ERR_SYSMEM_INSUFFICIENT
See Also
AWE_SELECT_SYN_BANK, AWE_GET_SYN_BANK
AWE_GET_SYN_BANK
Actions
An application sends this message to the AWE Manager to query for the
current Synthesizer Bank and its descriptor.
Parameters
lParam1
Specify a far pointer to CBufferObject, LPBUFFEROBJECT. When the
application calls the manager, the following fields are used: