(Page 1 of 1 in this chapter) Version


Appendix D

BRI Service Parameters


BRI Service Parameters

The BRI service stores its start parameters in the BRI_START_PARMS data structure. The following section describes each parameter in BRI_START_PARMS. It also lists the function that is affected by the specified parameter structure, shows the data structure, and provides detailed information about each parameter in the structure. The parameters are listed in alphabetical order.

The following CT Access functions obtain or modify parameter information:

For more information about parameter management in CT Access, refer to the CT Access Developer's Reference Manual.

BRI_START_PARMS

Dependent Function

briStartProtocol

Related Data Structure

The parameter structure is defined as follows:

typedef struct
{
  DWORD size;
  DWORD eventmask;
  WORD  rate;
  WORD  exclusive;
  unsigned char services_list[CC_MX_SERVICES];
} BRI_START_PARMS;

BRI_START_PARMS Fields

The BRI_START_PARMS structure contains the following fields:

eventmask

Type

DWORD

Units

mask

Default Value

0x004E

Allowed Values

A value may be formed by ORing any of the following bit masks:

Value Event Returned to the Application

2 BRIEVN_CALL_PROCEEDING

4 BRIEVN_REMOTE_ALERTING

8 BRIEVN_REMOTE_ANSWERED

64 BRIEVN_STATUS_UPDATE


For example, if eventmask = 0x002, the BRIEVN_CALL_PROCEEDING event will be received by the application.

Description

Controls reporting of informational call control events.

rate

Type

DWORD

Units

IDU

Default Value

ISDN_RATE_64K

Allowed Values

· ISDN_RATE_64K

· ISDN_RATE_56K (for future use)

Description

For future use. Specifies the transfer rate on the B-channel.

exclusive

Type

DWORD

Units

mask

Default Value

0

Allowed Values

Value Description

0 Non-exclusive mode

1 Exclusive mode

Description

For future use.

services_list

Type

DWORD

Units

IDU

Default Values

VOICE_SERVICE and RAW_TELEPHONY_SERVICE

Allowed Values

The available services are:

Service Description

NO_SERVICE Undefined service

VOICE_SERVICE Call for voice service

DATA_SERVICE Call for data service (for future use)

RAW_TELEPHONY_SERVICE Call for raw telephony service

FAX_SERVICE Call for G3 fax service

Description

Specifies the list of services supported on incoming calls.

The services_list is common to all B channels of a BRI trunk interface. Use the same list for all CTA contexts opened on the same BRI trunk when calling briStartProtocol. To set the list, specify the call type, one after each other. The last entry on the list should be NO_SERVICE. If the services_list is empty, VOICE_SERVICE is used by default.



(Page 1 of 1 in this chapter) Version


tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.