SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
51
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
Member
Remarks
m_Size
Indicates the size of buffer available.
m_Buffer
Far pointer to a buffer area.
Upon returning, the manager will update the following fields:
Member
Remarks
m_SizeUsed
Number of characters from buffer used.
m_Flag
The synthesizer emulation index.
m_Buffer
String of current bank descriptor.
The buffer area will be filled by the manager with the descriptor of the
current Synthesizer Bank. The m_Flag will contain the Synth Bank Index to
the available emulation.
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
See Also
AWE_QUERY_SYN_SUPPORT, AWE_SELECT_SYN_BANK
AWE_SELECT_SYN_BANK
Actions
An application sends this message to inform the AWE Manager of the
emulation it wishes to use as current Synthesizer Bank.
Parameters
lParam1
Specify a word data type. This word contains the SBank Index, pointing to
the desired Synthesizer Emulation. The following shows a list of available
Emulations loadable into Synthesizer Bank:
String
Idx
Entry
File
"General MIDI"
0
GM
SYNTHGM.SBK
"GS"
1
GS
SYNTHGS.SBK