RtndAttachToReceiveQueue

RtndAttachToReceiveQueue attaches a NAL client application to the driver receive queue to start receiving packets.

Syntax

int RtndAttachToReceiveQueue (   
   ULONG InterfaceNumber,
   ULONG QueueNumber,
   RTN_FN_PKT_CALLBACK fpCallback,
   VOID * pAppContext
);

Parameters

InterfaceNumber

The driver interface index.

QueueNumber

The driver queue number.

fpCallback

The callback function to be called from RtndReceive or RtndReceiveWithCallback. Can be NULL.

pAppContext

The application context pointer used as in RTNAL_FRAME structure in a callback.

Return Value

A return value of 0 indicates Success, -1 indicates Failure. The possible error codes are:

Error Code	Meaning
ERROR_BAD_ARGUMENTS	Invalid interface index or queue number.

Remarks

This function must change the queue state to application-attached and save the application context pointer and the receive packet callback pointer.

Requirements