SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
61
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
AWE_GET_UBANK_PARENT
Actions
An application sends this message to manager requesting the it identify the
original parent of specified user bank. This parent is considered as the bank
which loads the user bank.
Parameters
lParam1
A far pointer to a WORD containing the User Bank index. The valid range for
this is 1 to 127.
The driver upon returning will fill or change the contents of this word. Three
types of values may be returned.
lParam1
Remarks
Unchanged
The User Bank in query actually is self loaded
(i.e. parent of itself).
0 to 127
The User Bank is loaded in by other bank. The
parent bank has the index from 0 to 127. 0
signify Synthesiser Bank.
-1
The User Bank in query is not loaded yet.
lParam2
Unused
Remark
This message is introduced because there is no way to differentiate between
a User Bank that is self-loaded or loaded by other User Bank.
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_RESOURCE_INSUFFICIENT
See Also
None.
AWE_QUERY_DRAM_SIZE
Actions
An application sends this message to the AWE Manager to request for current
available and maximum DRAM size in the AWE hardware.
Parameters
lParam1
Specify a far pointer to a double word, DWORD FAR *. This location will
be used to store the maximum amount of DRAM found on the hardware.
lParam2
Specify a far pointer to a double word, DWORD FAR *. This location will
be used to store the current available amount of DRAM found on the
hardware.
hUserID
Current ID assigned to the application by the AWE Manager during
initialization.
Remarks
The unit for both lParam1 and lParam2 is words. That is, the return size is
in terms of number of words.
