SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
42
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
Unused.
Remarks
The returned number gives an indication of how many AWE32 devices are
actually supported by the MIDI driver. This is dependent on the different
Windows platforms. Currently, only Windows 95 supports multiple devices.
For other platforms, the number returned will always be 1 if the driver is
successfully initialized.
Return
The return value is AWE_NO_ERR if the operation is successful, and an
error code otherwise.
See Also
AWE_GET_DEVICE_CAPS
AWE_GET_DEVICE_CAPS
Actions
An application sends this message to AWE Manager when it wishes to know
the capabilities of a device.
Parameters
lParam1
Specify a DWORD data type. This parameter can either contain a device id
or device node. Device Id simply ranges from 0 to the maximum number of
devices supported by the driver.
lParam2
Specify a far pointer to CDevObject (LPDEVOBJECT) data type. The DLL
will fill this structure with the capabilities of the device.
hUserID
Unused.
Remarks
The m_SizeOf field of CDevObject structure must be initialized first before
calling this API. This is to ensure that future version of API will not have
problem filling up the entries of the structures. The members of this structure
are:
Member
Remarks
m_SizeOf
Contains the size of the CDevObject.
m_BaseAddr
Contains the base I/O address of the device in
question. e.g 0x620, 0x640 etc.
m_DevNode
Contains the device node of the device (Windows
95).
m_RomId
Contains the ROM ID of the device.
m_RomVer
Contains the ROM version of the device.
m_hTask
Contains the task of the application that is currently
owning the device.
m_DevCaps
Contains the driver’s capabilities in supporting the
device. This member is BIT-ORed.
m_DevName[32]
Contains the official name of the device registered in
the system.
m_SndEngine[16]
Contains the name of the sound engine supported by
the device.
m_RegKey[256]
Contains the registry key which information are
stored (Windows 95).