RTN_FN_PKT_CALLBACK

RTN_FN_PKT_CALLBACK is a pointer to an application function that is called for received or transmitted packets.

Syntax

BOOL (*RTN_FN_PKT_CALLBACK)(
	PRTNAL_FRAME pNalFrame
);

Parameters

pNalFrame

A pointer to structure RTNAL_FRAME.

Return Value

If a packet is received by RtNalReceive and the callback returns TRUE, RtNalReceive will fail with an error code ERROR_DISCARDED. If the callback returns FALSE, RtNalReceive will succeed so that the receive thread can process the packet.

Remarks

If an application uses RtNalReceiveWithCallback or the receive polling timer, the queue must be configured with the receive packet callback.

If an application uses RtNalReceive the driver will call this callback if the queue was configured with the receive packet callback.

If an application uses RtNalTransmitEx the callback will be invoked for a transmitted packet if the queue was initialized with transmit complete notifications and a non-zero callback pointer passed to RtNalTransmitEx in the NAL frame structure for this packet. The callback is invoked from the transmit complete thread in the application context when the packet transmission is complete.

Requirements

Minimum Supported Version	RTX64 4.0
Header	rtnapi.h, RtNalApi.h
Library	RtNal.lib