User`s guide

KwikNet Low Level Services

DAK

161

kn_ifnethook kn_ifnethook

Purpose Register a Network Hook Function for a 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"

int kn_ifnethook(KN_NETDP netdp, KN_FNP_NETHOOK nethookfn);

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

the network interface of interest.

Parameter nethookfn is a pointer to your network hook function. This

function is described in Appendix A.1 of the

KwikNet Device Driver

Technical Reference Manual. This function will be called the next time

the network interface is opened.

To remove a previously installed network hook function, call this

procedure with parameter

nethookfn set to (KN_FNP_NETHOOK)0L.

Returns If successful, 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 nethookfn is NULL.