User`s guide

160

DAK

KwikNet Low Level Services

kn_ifmodem kn_ifmodem

Purpose Attach the Modem Driver to a Network Interface

Used by

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

Setup Prototype is in file KN_API.H.

#include "KN_LIB.H"

int kn_ifmodem(KN_NETDP netdp, const struct knx_mdmdef *mdefp);

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

the network interface of interest.

Parameter mdefp is a pointer to a modem definition structure which

specifies the configuration parameters for the modem which is attached

to the network interface. The modem definition structure is described

in Chapter 1.7 of the KwikNet Device Driver Technical Reference

Manual. The structure is defined in file KN_API.H.

Note that the structure referenced by mdefp must be declared static

and must remain constant once it is attached to the network interface.

You can attach an alternate modem definition to the network interface

as long as the interface is first closed. You cannot remove the modem

definition once it is attached.

Returns If the modem driver is successfully attached to the network interface, a

value of 0 is returned.

On failure, one of the following error status codes is returned:

KN_ERPARAM Parameter netdp does not refer to a valid network or

parameter mdefp is NULL.

KN_ERLOGIC KwikNet is not configured to provide modem support.

Note The modem will not be configured and connected to the remote system

until the network interface is opened.