Starts the ISDN protocol on a specified CTA context.

DWORD briStartProtocol ( CTAHD ctahd,
char *protoname,
WORD *protoparms,
BRI_START_PARMS *parms )

ctahd CTA context handle returned by ctaCreateContext.

protoname Name of the protocol. Must be "BRI_PROTOCOL" or BRI_CURRENT_PROTOCOL.

protoparms Must be NULL.

parms Pointer to a BRI_START_PARMS structure, as shown (NULL uses default parameter values):

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

Refer to Appendix D for more information about this structure.

• SUCCESS
• CTAERR_BAD_ARGUMENT
  protoname is invalid or NULL or parms contains an invalid size field.
• CTAERR_DRIVER_SEND_FAILED
• CTAERR_INVALID_CTAHD
• CTAERR_INVALID_STATE

• BRIEVN_INCOMING_CALL
  An inbound call has been received. All incoming call information has been collected.
• BRIEVN_STARTPROTOCOL_DONE
  If successful, the value field contains CTA_REASON_FINISHED; otherwise, value contains an error code, such as:
• BRI_REASON_ERRORCONF
  The ISDN protocol is not correctly initialized.

This function initiates the ISDN protocol for the specified port and CTA context.

briStartProtocol must be called before any call control functions are invoked. After the protocol is started, call control functions, such as briPlaceCall, may be issued and detection of inbound calls will be reported.

For more information about starting the ISDN protocol stack, refer to Section 3.4.

briStopProtocol

int myStartProtocol( CTAHD ctahd, char )
{
 CTA_EVENT event;

    /* start specified protocol with all default parameters */
    if( briStartProtocol( ctahd, "BRI_PROTOCOL", NULL, NULL ) != SUCCESS )
        return MYFAILURE;

    do 
    {
        myGetEvent( &event );           /* see ctaWaitEvent example */
    } while( event.id != BRIEVN_STARTPROTOCOL_DONE );

    if( CTA_IS_ERROR( event.value ) )
        return MYFAILURE;               /* API error */
    else
        return SUCCESS;                 /* started successfully */
}