RtndReceiveWithCallback

RtndReceiveWithCallback is called to invoke a receive packet callback for a single received packet from a driver’s receive queue.

Syntax

int RtndReceiveWithCallback (
       ULONG interfaceNum, 
	ULONG queueNumber
);

Parameters

InterfaceNumber

The driver interface index.

QueueNumber

The driver queue number.

Return Value

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

Error Code	Meaning
ERROR_BAD_ARGUMENTS	The provided arguments are invalid.
ERROR_NO_NETWORK	The device is not up.
ERROR_NO_DATA	There is no packet waiting to receive.
ERROR_DEVICE_NOT_CONNECTED	There is no NAL client application attached to the receive queue.
ERROR_IO_DEVICE	Receive frame error.
ERROR_NOT_SUPPORTED	The receiving application did not supply the receive packet callback.

Remarks

If the adapter has stored the timestamp with a packet, the driver should provide the timestamp in a receive packet callback.

The function does not copy packet data.

Process Context

RtndReceiveWithCallback is used in a context of NAL client application by RtNalReceiveWithCallback or a polling timer.

Requirements