SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
40
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
AWE_VIENNA_NOTE_OFF
Turn off a note
AWE_VIENNA_CONTROLLER
Send a MIDI Controlller message to driver
AWE_VIENNA_PITCH_BEND
Send a MIDI Pitch Bend message to driver
AWE_VIENNA_CHANNEL_PRESSURE
Send a MIDI Channel Pressure message to driver
AWE_VIENNA_SYSEX
Send a MIDI SysEx message to driver
AWE_VIENNA_GET_DRAM_SIZE
Retrieve current available and maximum memory on the
AWE32 hardware
Message Reference
Explanations of messages from the manager are documented below.
AWE_OPEN
Actions
An application sends this message to AWE Manager when it wishes to
acquire the manager.
Parameters
lParam1
Specify a far pointer to a user declared handle type, AWEHANDLE. The DLL
fills this location with a
hUserID
value if the initialization is successful.
lParam2
Specify a device number starting from 0 to (max. device - 1).
hUserID
Unused.
Remarks
This message can only be called once for each hardware device during
initialization.
The manager will check for the existence of the MIDI driver and in-turn
register with it. If the driver fails because of hardware failure or contention,
this function will also fail. Upon successful initialization, the manager will
return a unique user identification (handle) to the application. All subsequent
calls to the manager should have this ID associated with
Following files must be present in Windows,
SBAWE32.DRV
- AWE MIDI Driver v4.0 or above
Driver version 4.0 will have file time-stamp 4.00a or later. Opening more
than once will cause the manager to return a busy message. If the MIDI driver
is not available at the time of Open, the manager will still fail and return the
access not permitted message. Such cases happen, for example, when Media
Player has already acquire the MIDI device before the user application opens
the manager
Return
The return value would be AWE_NO_ERR if the operation is successful and
an error code otherwise. Possible error messages are:
AWE_ERR_DEVICE_DRV_INVALID