SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
59
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
AWE_ERR_USERID_INVALID
AWE_ERR_DEVICE_BUSY
AWE_ERR_PATHNAME_INVALID
AWE_ERR_USER_OBJ_INVALID
AWE_ERR_INSTR_INVALID
AWE_ERR_UBANK_INVALID
AWE_ERR_RESOURCE_INSUFFICIENT
AWE_ERR_SYSMEM_INSUFFICIENT
AWE_ERR_DRAM_INSUFFICIENT
See Also
AWE_CLEAR_USER_INSTR
AWE_GET_USER_INSTR
Actions
An application sends this message to the AWE Manager to request for an
instrument descriptor of the Synthesizer Bank or User Bank.
Parameters
lParam1
Specify a far pointer to a CParamObject data type, LPPARAMOBJECT. The
application should fill the following field with appropriate values:
Member
Remarks
m_UBankIndex
The index to destinate User Bank.
m_InstrIndex
The index to an Instrument within the UBank.
The m_InstrIndex will be the instrument offset of the User Bank specified by
UBank Index. The m_InstrIndex must be a valid value between 0 to 127.
lParam2
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_Buffer
String of current instrument descriptor.
The buffer area will be filled by the manager with the descriptor of the
instrument.
hUserID
Current ID assigned to the application by the AWE Manager during
initialization.