AudioScience HPI Version_4.18.

OS Specific Implementations

Win32

The HPI can be run as a Win32 program under Windows NT/2000/XP/Vista/Windows7. The HPI runs as a kernel mode driver and links to the Win32 audio application via an IOCTL interface. Under Win2000/XP/Vista/Windows7 the driver is a kernel driver called asihpiwn.sys

Prior to driver 3.00, customers writing HPI level applications for Windows would link HPIFUNC.C into their application. This has the drawback of limiting some internal HPI structures to 32-bit only. The more transparent approach is to have AudioScience provide a DLL that implements the functions in HPIFUNC.C so as to shield the customer's application from internal HPI structure sizes. We call the 32-bit version of this DLL ASIHPI32.DLL. All functions previously available in HPIFUNC.C are available via ASIHPI32.DLL.

The following compiler defines should be used for any 32-bit project that interfaces with ASIHPI32.DLL - HPIDLL_IMPORTS;HPI_OS_WIN32_USER.

See NOTE0013 for more info on the changes between 2.XX and 3.XX

os_win32.png

Debugging

The following description applies to driver 3.06.00 and later.

In ASIDRV.INI (in your windows directory) find the [Audio Science Driver Information] section and set Internal Error Logging to 'on' and Error Logging Level to 'Error' - or whatever other level you wish to use. Reboot the computer after ASIDRV.INI has been edited so that the changes will take effect.

[Audio Science Driver Information]
Internal Error Logging=on
Error Logging Level=error

Valid levels are:

LevelHPI defineDescription
error HPI_DEBUG_LEVEL_ERROR Error condition, driver/adapter probably won't work
warning HPI_DEBUG_LEVEL_WARNINGCondition shouln't normally happen, but adapter keeps working
notice HPI_DEBUG_LEVEL_NOTICE Normal but significant condition
info HPI_DEBUG_LEVEL_INFO Informational eg success of driver loading, which cards detected
debug HPI_DEBUG_LEVEL_DEBUG Debug: tracing normal operation. This will allow you to see all HPI messages.
verbose HPI_DEBUG_LEVEL_VERBOSEVerbose debug = extreme detail, huge log files

Run WinDbg?.exe or DebugView?.exe (both available on Microsoft's website) to view the messages. Get DebugView? here: http://www.microsoft.com/technet/sysinternals/utilities/debugview.mspx

Linux

The HPI can be run under Linux with kernels of version 2.2 or greater. The HPI takes the form of a loadable kernel module called ASIHPI.O. The user app links to LIBHPI.O

os_linux.png