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.
To Next Page
Loading...