Reference Guide
ARK Exceptions
Below is a description of the exceptions that can be raised within ARK methods. Both the exception numbers and a description of when they can occur are provided. The exception numbers are returned as HRESULT values from ARK methods in C++. In Visual Basic, when an exception occurs, the exception number can be obtained from the Number property in the Err object (i.e. Err.Number). For C++ programmers, the exceptions are defined in the header file ArkExceptions.h, which is included in the ARK\Languages\MSVC\Include directory in ARKsdk.
Controller Component Exceptions
E_ARK_DEVICE (value 800405ED hex) indicates an exception pertaining to the connected hearing instrument. This can occur in WhichChip when the instrument is not recognized, in Burn (for PARAGON only) if a new instrument has been connected since the last time Init was called, and in almost all of the methods if no instrument is connected. If this exception occurs, the fitting software should recommend that the user check the hearing instrument's connections and re-initialize it.
E_ARK_PROGRAMMER (value 800405EF hex) indicates that one of the lower level programming box DLL functions failed. When using the HiPro Component provided by Gennum, this exception can also indicate that the User ID has been changed by another program. If this error occurs, the software should call Close and then Open again.
E_ARK_BUG (value 800405F0 hex) indicates that the fitting software has called the methods out of sequence (i.e. WhichChip before Open, or Read before Init), or has passed an invalid argument (i.e. an invalid memory number).
When SwitchToMemory is called, two other types of exceptions can occur. E_ARK_CONFIGURATION (value 800405E9 hex) indicates that the software attempted to switch to a memory that was marked as not being valid. E_ARK_PARAMETER (value 800405E8 hex) indicates that the fitting software attempted to switch memories when the device was in static mode.
When Open is called, E_ARK_INSTALLATION (value 800405EE hex) indicates that an invalid underlying DLL version or firmware version is installed.
Lastly, E_ARK_INTERNAL (value 800405EA hex) indicates that an internal ARK exception occurred. If this exception happens repeatedly, please e-mail software@gennum.com for assistance.
Product Component Exceptions
E_ARK_PARAMETER (value 800405E8 hex) indicates that invalid parameter settings have been chosen. This usually happens when a channel AGC is set up in an invalid way (the compression ratio must be between 1:1 and infinite:1). This check is made when GetControllerMemoryEx or Prepare are called. The IDS handles this type of exception by reverting the parameters (and the sliders in the GUI) to the last valid state.
E_ARK_FREQ (value 800405EC hex) indicates that the component (or the application) tried to get a value using CalcPoint outside of the frequency range covered by the transducer lookup tables. If you use the Modeler to generate your look-up tables and do not try to plot frequency points outside of [125, 8000] in frequency, you should not encounter this exception.
E_ARK_CONFIGURATION (value 800405E9 hex) should not occur unless a parameter map is set up incorrectly. Please e-mail software@gennum.com if this exception is received when using a product component library created with ARKonline.
|
