(Page 7 of 13 in this chapter)
TxApiOpen
Description
- Calls cpi_init to initialize the CPI Library for use by the Common Management API.
Prototype
- TXAPIHNDL *TxApiOpen (unsigned char board,
unsigned short swint,
short *errno)
- board Board number to be opened (1..MAX_CP,
or 0 = receive from all communications processors).
- swint For DOS only, pointer to software interrupt assigned to TX driver for this board; for other operating systems, not used.
- errno Pointer to error information.
Return Values
- Returns a TX Management API handle (TXAPIHNDL) to be used in other Common Management API functions or NULL (errno indicates error). For more information about the TXAPIHNDL structure, refer to Appendix C. For more information about Common Management API errors, refer to Appendix B.
Details
- A single call to TxApiOpen is all that is required for a single communications processor system. For systems containing multiple TX board communications processors, the application may either issue a single open (specifying 0 for board number) or issue multiple opens (obtaining a set of handles). If multiple TxApiOpen calls are issued, the TX API will only initialize the CPI Library once.
- After successfully initializing the CPI LIbrary, TxApiOpen registers (cpi_open) to receive dual port RAM packets (IO responses) from the NETMGR task on the indicated communications processor (board). TxApiOpen must be called before any other Common Management API function that requires a TX API handle can be used.
See Also
- TxApiClose
(Page 7 of 13 in this chapter)
tech_support@nmss.com
Copyright © 1998, Natural MicroSystems, Inc. All rights
reserved.