(Page 5 of 5 in this chapter)


Error Codes Ordered By Value

The following table lists error codes by ascending hexadecimal value:

Hex

Decimal

Error Name

Description

0x00000002

2

CTAERR_FATAL

An internal error occurred in the AG Access library. Please contact NMS developer support.

0x00000003

3

CTAERR_BOARD_ERROR

An unexpected error occurred on the AG board. In most cases, there will also be an ADIEVN_BOARD_ERROR event, which will contain the board error code.

0x00000005

5

CTAERR_INVALID_CTAHD

The context handle is invalid.

0x00000006

6

CTAERR_OUT_OF_MEMORY

Unable to allocate memory for driver or port context, for play or record buffers, or for temporary storage. When this error occurs in a done event, it may mean that there was insufficient memory on the AG board.

0x00000007

7

CTAERR_BAD_ARGUMENT

A function argument had an invalid value or a required pointer argument was NULL.

0x00000008

8

CTAERR_OUT_OF_RESOURCES

Unable to create shared resources.

0x00000009

9

CTAERR_NOT_IMPLEMENTED

Function was not implemented. (This error code is reserved for future use.)

0x0000000a

10

CTAERR_NOT_FOUND

The specified parameter does not exist.

0x0000000b

11

CTAERR_BAD_SIZE

A size argument was too small to receive a data structure, or a play or record buffer was not a multiple of the framesize for the specified encoding.

0x0000000c

12

CTAERR_INVALID_STATE

The function is not valid in the current port state. For example, most functions require the port to be in the ADI_STATE_STARTED state, which is entered after starting a trunk protocol.

0x0000000d

13

CTAERR_FUNCTION_NOT_AVAIL

Either the necessary .dsp or .tcp file has not been downloaded to the board, or the requested function required a service that is reserved for use by call control; or a requested call control operation is not available with the current protocol.

0x0000000e

14

CTAERR_FUNCTION_NOT_ACTIVE

An attempt was made to stop or modify a function that was not running.

0x0000000f

15

CTAERR_FUNCTION_ACTIVE

An attempt was made to start an async function that is already started. Also returned if an attempt was made to get a digit or flush the digit queue while collecting digits.

0x00000010

16

CTAERR_SHAREMEM_ACCESS

Failed accessing shared memory.

0x00000013

19

CTAERR_INVALID_SEQUENCE

Either an attempt was made to stop a function that is already being stopped; or a call control function was called before receiving a response to the previous call control command; or a play or record buffer was submitted when it was not expected.

0x00000014

20

CTAERR_DRIVER_OPEN_FAILED

The AG driver open failed because either the AG driver was not installed or the maximum number of opens has been exceeded.

0x00000015

21

CTAERR_DRIVER_VERSION

The AG driver does not support the requested function.

0x00000016

22

CTAERR_DRIVER_RECEIVE_FAILED

An error occurred retrieving an event from the AG driver or no events were queued in the driver.

0x00000017

23

CTAERR_DRIVER_SEND_FAILED

An error was returned by the AG driver in sending a message to the AG board. This error will occur if the board has been reset.

0x0000001a

26

CTAERR_INVALID_BOARD

The specified AG board number has not been successfully configured.

0x0000001b

27

CTAERR_OUTPUT_ACTIVE

Either open port failed because the stream and slot are already opened on another port; or an output operation such as play failed because there is another active output function.

0x0000001d

29

CTAERR_LOCK_TIMEOUT

A thread lock timed out.

0x00010001

65537

ADIERR_PLAYREC_ACCESS

The user callback routine for playing or recording returned a value other than SUCCESS or ADI_PLAY_LAST_BUFFER.

0x00010002

65538

ADIERR_INVALID_QUEUEID

Bad queue or driver ID.

0x00010003

65539

ADIERR_UNKNOWN_BOARDTYPE

The AG board type is unrecognized (adiGetBoardSlots).

0x00010004

65540

ADIERR_TOO_MANY_BUFFERS

Attempted to submit a play or record buffer with two buffers pending.

0x00010005

65541

ADIERR_INVALID_CALL_STATE

The function is not valid in the current call state. For example, many functions require the call to be in the ADI_CC_STATE_CONNECTED state.

0x00010006

65542

ADIERR_CANNOT_CREATE_CHANNEL

Unable to create a channel to the AG board due to either board or driver limitations.

0x00010007

65543

ADIERR_NO_DSP_PORT

No input or output stream for requested function.



(Page 5 of 5 in this chapter)


Tech_Support@nmss.com
Copyright © 1996, Natural MicroSystems, Inc. All rights reserved.