SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
60
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
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 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 will be AWE_NO_ERR if the operation is successful, and
an error code otherwise. Possible errors are:
AWE_ERR_USERID_INVALID
AWE_ERR_UBANK_INVALID
AWE_ERR_INSTR_INVALID
AWE_ERR_RESOURCE_INSUFFICIENT
See Also
AWE_LOAD_USER_INSTR, AWE_CLEAR_USER_INSTR
AWE_CLEAR_USER_INSTR
Actions
An application sends this message to clear an instrument's presets located in
the User Bank area.
Parameters
lParam1
Specify a word data type. The word contains the UBank Index where the
instrument is to be removed from.
lParam2
Specify a word data type. This word contains the instrument number in the
User Bank specified by the UBank Index in lParam1. The instrument's
presets will be deleted from the memory area.
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_INSTR_INVALID
AWE_ERR_UBANK_INVALID
See Also
AWE_LOAD_USER_INSTR