Returns the text representation of an error code.

DWORD adiGetErrorText( DWORD errcode,
char *text,
unsigned size )

errcode AG Access error code.

text Buffer to receive description.

size Size (bytes) of buffer to receive description.

• SUCCESS
• CTAERR_BAD_ARGUMENT
  text is NULL.
• CTAERR_BAD_SIZE
  size is 0.

None.

adiGetErrorText returns a NULL-terminated text string in text that corresponds to the AG Access error in errcode. Refer to Appendix A for a list of AG Access errors. Pass a buffer size of at least 40 bytes. If size is too small to contain the entire description, (size - 1) bytes will be copied, followed by a NULL termination.

adiGetEventText, adiSetErrorHandler

DWORD myFetchAndProcess( unsigned drvid, ADI_EVENT *event )
{
    char      errortext[40];
    char      eventtext[40];
    DWORD     ret;

    ret = adiFetchAndProcess( drvid, event );
    if( ret != SUCCESS )
    {
        adiGetErrorText( ret, errortext, sizeof errortext );
        printf( "adiFetchAndProcess failed: %s.\n", errortext );
    }
    else if( event->value != 0 )
    {
        adiGetEventText( event->id, eventtext, sizeof eventtext );

        if ( IS_ADI_DONE( event->id ) && IS_ADI_ERROR( event->value ) )
        {
            adiGetErrorText( event->value, errortext, sizeof errortext );
            printf( "%s, error=%s (%08X)\n", eventtext, errortext, ret );
        }
        else
            printf( "%s\n", eventtext );
    }
    return ret;
}