SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
57
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
See Also
AWE_LOAD_WAVEFX,
AWE_GET_WAVEFX_PATH
AWE_GET_WAVEFX_PATH
Actions
An application sends this message to inform the AWE Manager that it wishes
to retrieve the path of WaveFX.
Parameters
lParam1
Unused
lParam2
Specify a far pointer to CBufferObject, LPBUFFEROBJECT. When the
application calls the manager, the following fields are used:
Member
Remarks
m_Flag
Instrument Number of the WaveFX which path
required to be retrieved.
m_Buffer
Far pointer to a buffer area.
Note : Only the path of WaveFXs loaded to Bank 0 can be retrieved.
hUserID
Current ID assigned to the application by the AWE Manager during
initialization.
Remarks
The following are some important points to note when using this function.
The location passed in as pointer must be valid memory locations allocated
by the parent application. If the locations are invalid, it is possible to trip a
General Protection Fault in Windows.
Return
The return value will be AWE_NO_ERR if the operation is successful, and
an error code otherwise. Possible errors are:
AWE_ERR_USERID_INVALID
AWE_ERR_DEVICE_BUSY
AWE_ERR_PATHNAME_INVALID
AWE_ERR_USER_OBJ_INVALID
AWE_ERR_UBANK_INVALID
AWE_ERR_RESOURCE_INSUFFICIENT
AWE_ERR_SYSMEM_INSUFFICIENT
AWE_ERR_DRAM_INSUFFICIENT
See Also
AWE_LOAD_WAVEFX,
AWE_CLEAR_WAVEFX