(Page 10 of 19 in this chapter)
SCCPInitAPI
Description
- Initializes the SCCP API for the calling application and registers the application with the TX Series driver.
Prototype
- OS_FD SCCPInitAPI (U8 board, U8 srcEnt, U8 srcInst )
- board The TX Series board number to which this request is directed.
- srcEnt Calling application's entity ID.
- srcInst Calling application's instance ID.
Return Values
Details
- The application may register with a specific TX Series board or with all boards in a single call. When registering for specific boards, this function must be called once for each board it wishes to use the SCCP API with. This function must be called before any of the other SCCP API functions.
- The type returned by this function, SCCPFD, is an operating system dependent type defined to the type of a driver file descriptor or file handle on the chosen operating system. The value returned (when successful) is a valid file descriptor which may be used by the application to simplify receiving of messages from the SCCP layer.
- For example, the value returned on UNIX systems is a file descriptor for an open streams device. The application may use this file descriptor with the poll or select system calls to determine when a message from the SCCP layer is available. The application may then call SCCPRetrieveMessage to read and decode the message (i.e., the application should not call getmsg directly).
(Page 10 of 19 in this chapter)
tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights
reserved.