RtndReceive

RtndReceive is called when an incoming frame is received from the NIC driver.

The filter normally reads the frame by using RtnDecodePacket. RtndReceiveFilter will be called once per frame. The filter can elect to send the frame by calling RtnQueueRecvFrame and returning STATE_CONTINUE or drop the frame by calling STATE_DISMISS.

Syntax

FRAME_STATE RtndReceive(
   void *ndptr,
   void *mptr,
   unsigned long framesize
);

Parameters

ndptr

Network Device Pointer. Opaque network device identifier (pointer).

mptr

Pointer to the frame to queue in the device receive queue. This is used as a parameter to RtnDecodePacket to access various fields in the stack defined frame structure.

framesize

This is the number of bytes read from the card and placed in the frame.

Return Values

A return value of STATE_DISMISS indicates the frame is being dropped. STATE_CONTINUE indicates it is being sent to the stack.

Process Context

RtndReceiveFilter is always called from within the process context of the NIC Driver’s receive thread.