AMX DESIGN XPRESS V 1.5 - PROGRAMMER GUIDE User's Guide download pdf (Page 176)

162

DAK

KwikNet Low Level Services

kn_ifnext kn_ifnext

Purpose Find the Next Available Network Interface

Used by

n Task o ISP o Timer Procedure o Restart Procedure n Exit Procedure

Setup Prototype is in file KN_API.H.

#include "KN_LIB.H"

KN_NETDP kn_ifnext(KN_NETDP netdp);

Description Netdp is a network descriptor pointer, the KwikNet handle used to identify

the currently selected network interface of interest.

If netdp is NULL, the first available network interface will be selected.

KwikNet maintains a list of network interfaces that have been added to

the system since

KwikNet was last started. Since network interfaces can

be added but not removed, this list is always maintained in the order in

which interfaces are added. This procedure searches the list for the

next available interface following the interface specified by netdp or

starting at the head of the list if netdp is NULL.

Returns If successful, the network descriptor pointer for the next available network

interface is returned. This KwikNet handle can be used to identify the

network interface in subsequent calls to KwikNet procedures.

If there is no network interface following the one identified by parameter

netdp, a NULL network descriptor pointer is returned.

Example This procedure can be called repetitively to identify all network interfaces

and service each in some specific manner.

#include "kn_lib.h"

KN_NETDP netdp; /* Network descriptor */

netdp = NULL;

do {

netdp = kn_ifnext(netdp);

if (netdp && (kn_ifstate(netdp) == KN_NIFS_UP))

servicenet(netdp);

} while (netdp != NULL);

1 ... 175 176 177 ... 316

No comments

AMX DESIGN XPRESS V 1.5 - PROGRAMMER GUIDE User's Guide Page 176