This documentation is archived and is not being maintained.

ATM_CAUSE_IE structure

Note   NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

The ATM_CAUSE_IE structure specifies the cause information element of an ATM UNI signaling message. The cause information element describes the reason for generating certain messages, provides diagnostic information in the event of procedural errors, and indicates the location of the cause originator.

Syntax


typedef struct _ATM_CAUSE_IE {
  UCHAR Location;
  UCHAR Cause;
  UCHAR DiagnosticsLength;
  UCHAR Diagnostics[4];
} ATM_CAUSE_IE, *PATM_CAUSE_IE;

Members

Location

Specifies the location as one of the following values:

ATM_CAUSE_LOC_USER

User

ATM_CAUSE_LOC_PRIVATE_LOCAL

Private network serving the local user

ATM_CAUSE_LOC_PUBLIC_LOCAL

Public network serving the local user

ATM_CAUSE_LOC_TRANSIT_NETWORK

Transmit network

ATM_CAUSE_LOC_PUBLIC_REMOTE

Public network serving the remote user

ATM_CAUSE_LOC_PRIVATE_REMOTE

Private network serving the remote user

ATM_CAUSE_LOC_INTERNATIONAL_NETWORK

International network

ATM_CAUSE_LOC_BEYOND_INTERWORKING

Network beyond interworking point

Cause

Specifies the cause as one of the following values:

ATM_CAUSE_UNALLOCATED_NUMBER

Unallocated (unassigned) number

ATM_CAUSE_NO_ROUTE_TO_TRANSIT_NETWORK

No route to specified transit network

ATM_CAUSE_NO_ROUTE_TO_DESTINATION

No route to destination

ATM_CAUSE_VPI_VCI_UNACCEPTABLE

VPI/VCI assignment failure

ATM_CAUSE_NORMAL_CALL_CLEARING

Normal call clearing

ATM_CAUSE_USER_BUSY

User busy

ATM_CAUSE_NO_USER_RESPONDING

No user responding

ATM_CAUSE_CALL_REJECTED

Call was rejected.

ATM_CAUSE_NUMBER_CHANGED

Number changed

ATM_CAUSE_USER_REJECTS_CLIR

User rejects all calls with calling line identification restriction (CLIR).

ATM_CAUSE_DESTINATION_OUT_OF_ORDER

Destination out of order

ATM_CAUSE_INVALID_NUMBER_FORMAT

Invalid number format (address incomplete)

ATM_CAUSE_STATUS_ENQUIRY_RESPONSE

Status inquiry response

ATM_CAUSE_NORMAL_UNSPECIFIED

Normal unspecified

ATM_CAUSE_VPI_VCI_UNAVAILABLE

Requested VPI/VCI not available

ATM_CAUSE_NETWORK_OUT_OF_ORDER

Network out of order

ATM_CAUSE_TEMPORARY_FAILURE

Temporary failure

ATM_CAUSE_ACCESS_INFORMAION_DISCARDED

Access information discarded

ATM_CAUSE_NO_VPI_VCI_AVAILABLE

No VPI/VCI available

ATM_CAUSE_RESOURCE_UNAVAILABLE

Resource unavailable, unspecified

ATM_CAUSE_QOS_UNAVAILABLE

Quality of service unavailable

ATM_CAUSE_USER_CELL_RATE_UNAVAILABLE

User cell rate not available

ATM_CAUSE_BEARER_CAPABILITY_UNAUTHORIZED

Bearer capability is unauthorized.

ATM_CAUSE_BEARER_CAPABILITY_UNAVAILABLE

Bearer capability not presently available

ATM_CAUSE_OPTION_UNAVAILABLE

Option is unavailable.

ATM_CAUSE_BEARER_CAPABILITY_UNIMPLEMENTED

Bearer capability not implemented

ATM_CAUSE_UNSUPPORTED_TRAFFIC_PARAMETERS

Unsupported combination of traffic parameters

ATM_CAUSE_INVALID_CALL_REFERENCE

Invalid call reference value

ATM_CAUSE_CHANNEL_NONEXISTENT

Identified channel does not exist

ATM_CAUSE_INCOMPATIBLE_DESTINATION

Incompatible destination

ATM_CAUSE_INVALID_ENDPOINT_REFERENCE

Invalid endpoint reference

ATM_CAUSE_INVALID_TRANSIT_NETWORK_SELECTION

Invalid transmit network selection

ATM_CAUSE_TOO_MANY_PENDING_ADD_PARTY

Too many pending add party operations

ATM_CAUSE_AAL_PARAMETERS_UNSUPPORTED

AAL parameters cannot be supported

ATM_CAUSE_MANDATORY_IE_MISSING

Mandatory information element is missing.

ATM_CAUSE_UNIMPLEMENTED_MESSAGE_TYPE

Message type nonexistent or not implemented

ATM_CAUSE_UNIMPLEMENTED_IE

Information element nonexistent or not implemented

ATM_CAUSE_INVALID_IE_CONTENTS

Invalid information element contents

ATM_CAUSE_INVALID_STATE_FOR_MESSAGE

Message not compatible with call state

ATM_CAUSE_RECOVERY_ON_TIMEOUT

Recovery on timer expiration

ATM_CAUSE_INCORRECT_MESSAGE_LENGTH

Incorrect message length

ATM_CAUSE_PROTOCOL_ERROR

Protocol error, unspecified

DiagnosticsLength

Specifies the length in bytes of the buffer at Diagnostics.

Diagnostics

User-defined diagnostic information.

Remarks

ATM_CAUSE_IE can be included in a set of Q.2931 call manager-specific parameters.

ATM_CAUSE_IE is passed at IE in a Q2931_IE structure, which is passed at InfoElements in a Q2931_CALLMGR_PARAMETERS structure.

For more information about the cause information element, see the User Network Interface (UNI) Specification published by the ATM Forum.

Requirements

Header

Atm.h (include Atm.h)

See also

Q2931_IE
Q2931_CALLMGR_PARAMETERS

 

 

Send comments about this topic to Microsoft

Show: