SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
41
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
AWE_ERR_DLL_BUSY
AWE_ERR_SYSMEM_INSUFFICIENT
AWE_ERR_ACCESS_NOT_PERMITTED
AWE_ERR_VERSION_INVALID
See Also
AWE_CLOSE
AWE_CLOSE
Actions
An application sends this message to AWE Manager when it wishes to
release control of the acquired AWE32 device to other applications.
Parameters
lParam1
Unused.
lParam2
Unused.
hUserID
Current ID assigned to the application by AWE Manager during initialization.
Remarks
The following are some important points to note when using this function.
The close function will not cause Windows to unload the AWE Manager
from memory. Unloading depends on whether anymore application is still
accessing it. Only when the last application issues a close message, then the
manager will be unloaded. This is the 'last one off the lights' metaphor. When
the manager is unloaded by Windows, all unused handles will be 'clean' up
by the manager.
The application mentioned above can only be either user applications or
control panel application and not two or more of the same kind
Return
The return value is AWE_NO_ERR if the operation is successful, and an
error code otherwise. Possible error message is:
AWE_ERR_USERID_INVALID
See Also
AWE_OPEN
AWE_GET_NUM_DEVS
Actions
An application sends this message to AWE Manager when it wishes to
determine how many AWE devices are available on the system.
Parameters
lParam1
Specify a far pointer to a WORD data type. The DLL fills this location with
the number of AWE devices available on the system.
lParam2
Unused.
hUserID