SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
49
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
3 - Treble
lParam2
Unused.
hUserID
Current ID assigned to the application by the AWE Manager during
initialization.
Remarks
None.
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_EFXT_CHANGE_NOT_ALLOWED
AWE_ERR_EFXT_INVALID
AWE_ERR_EFXV_INVALID
See Also
AWE_QUERY_EFXT_SUPPORT, AWE_QUERY_EFXV_SUPPORT,
AWE_GET_EFX
AWE_QUERY_SYN_SUPPORT
Actions
An application sends this message to the AWE Manager to request a list of
available or supported Emulations for Synthesizer Bank.
Parameters
lParam1
Specify a far pointer to CBufferObject, LPBUFFEROBJECT. When the
application calls the manager, the following fields are used:
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
Number of entries written into the buffer.
m_Buffer
String entries of synthesizer emulation.
The buffer area will be filled by the manager with the entries of Synthesizer
Emulation supported by the current MIDI driver. These entries are in string
format, each delimited by a '\0'. The last entry of the list will have two
consecutive '\0's. Using the above example, we have:
"General MIDI\0GS\0MT 32\0User Custom Synth\0\0"
The size returned includes the '\0's used to delimit two entries. The current
version of MIDI driver supports the following Synthesizer Emulation: