Creative AWE32 - Error Messages

To Next Page

To Previous Page

SB AWE32 Developer's Information Pack PART III Windows Driver API •• 73

Error Messages

The error messages generated by the AWE Manager are described below. They can be divided into

three categories:

• General Error Messages

• Invalid Parameter Messages

• Resource Contention Messages

General Error Messages

AWE_NO_ERR No error message. This message will be display

most of the time to indicate a successful

operation.

AWE_ERR_UNDEFINE_ERROR A reserved error message indicating an error not

defined during development. A new error

message may be added to it at a later stage when

the cause of the error is identified.

Invalid Parameter Messages

AWE_ERR_DEVICE_DRV_INVALID This error message is return when the

SBAWE32.DRV MIDI driver is not located.

AWE_ERR_USERID_INVALID An invalid user ID is used to gain access to the

AWE Manager. This ID should be obtained from

the AWE_OPEN API call.

AWE_ERR_EFXT_INVALID An invalid Effect Type Index is specified. This

error happens when an application specifies an

Effect Type Index that is not currently supported

by the MIDI driver.

AWE_ERR_EFXV_INVALID An invalid Type Variation index is specified.

This error happens when an application specifies

a Type Variation index that is not supported by

the MIDI driver.

AWE_ERR_SBANK_INVALID An invalid Synthesizer Bank index is specified.

This error occurs when the MIDI driver cannot

support the specified Synthesizer Bank index.

AWE_ERR_PATHNAME_INVALID An invalid path name to a file is specified. This

happens when an operation, which requires a user

file or a predetermined path, cannot locate the

desired file.

AWE_ERR_USER_OBJ_INVALID An user object module has an incorrect format.

This error occurs when an application attempts to

download an unrecognized bank of instruments

(or single instrument) into a specific User Bank

area. This module uses the SBK format.