SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
43
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
Return
The return value is AWE_NO_ERR if the operation is successful, and an
error code otherwise.
See Also
AWE_GET_NUM_DEVS
AWE_QUERY_EFXT_SUPPORT
Actions
An application sends this message to the AWE Manager to retrieve a list of
supported Effect Types.
Parameters
lParam1
Specify a far pointer to CBufferObject, LPBUFFEROBJECT. When the
application calls the manager, the following fields are used:
Member
Remarks
m_Size
Buffer size in characters.
m_Buffer
Far pointer of buffer area.
The manager upon returning will fill or change the following fields:
Member
Remarks
m_SizeUsed
Number of characters from buffer used.
m_Flag
Number of entries stored in buffer.
m_Buffer
String entries of effect types.
The m_SizeUsed includes the '\0's used to delimit entries. Current version of
MIDI drivers support only one Effect Type. The string representations (not
including quotes) are as follows:
String
Type
Sub-Index
"Reverb & Chorus"
0
0 - Reverb
1 - Chorus
2 - Bass
3 - Treble
The buffer area will be filled with Effect Types supported by the current
MIDI driver. These entries are in string format, each terminated with a '\0'.
The last entry of the list will have two consecutive '\0's. An example is:
"Reverb & Chorus\0\0"
With the example above, the m_SizeUsed is 17 and m_Flag is 1.
lParam2
Unused.
hUserID
Current ID assigned to the application by the AWE Manager during
initialization.
Remarks
The followings are some important points to note when using this function.