RTNAL_QUEUE_EVENTS

RTNAL_QUEUE is a structure in which RtNalAcquireQueue returns notification event handles.

Syntax

typedef struct _RTNAL_QUEUE_EVENTS{
    HANDLE hRxEvent;
    HANDLE hTxCompleteEvent;
    HANDLE hLinkEvent;
    HANDLE hStopEvent;
}RTNAL_QUEUE_EVENTS, *PRTNAL_QUEUE_EVENTS;

Fields

hRxEvent

Auto-reset event used to notify an application of received packets. The event is set from RtnNotifyRecvQueue in the receive Interrupt Service Thread. Use RtNalGetReceivePacketCount to obtain the number of packets, placed in DMA since last call to RtNalGetReceivePacketCount.

hTxCompleteEvent

Auto-reset event used to notify an application of transmitted packets, when the DMA buffer descriptor becomes available. Transmit complete notification must be used if an application wants to use transmit complete callbacks with some of the packets transmitted by RtNalTransmitEx. If the application has requested to use transmit complete notification, the RTX64 NAL will run a transmit complete thread per queue in application context, which will use the handle hTxCompleteEvent. The application must not use this handle directly.

hLinkEvent

Auto-reset event used to notify an application about the link change events.

hStopEvent

Manual-reset event used to notify the application that the network queue is being released.

Requirements

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