ATM_CAUSE_IE structure

  • Article

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