RtNalRequest

RtNalRequest forwards a request to the underlying driver to query the requested capabilities or statistics of the RTX64-converted NIC card.

Syntax

BOOL RtNalRequest(
	RTNAL_QUEUE_HANDLE queueHandle,
	PRTND_REQUEST pRtndRequestStruct
);

Parameters

queueHandle

Network queue handle returned by RtNalAcquireQueue.

pRtndRequestStruct

The pointer to RTND_REQUEST type specifying RTX64 network adapter capabilities and statistics to request.”

Return Value

Returns TRUE if the call succeeds. Otherwise it returns FALSE. Call GetLastError to obtain an error code. The possible error codes are listed below:

Error Code	Meaning
ERROR_DEVICE_FEATURE_NOT_SUPPORTED	The NIC driver does not support the pRtndRequestStruct Oid .
ERROR_INCORRECT_SIZE	pRtndRequestStrucInformationBuffer is NULL or the information buffer is not big enough for the request.
ERROR_INVALID_PARAMETER	queueHandle or pRtndRequestStruct is a NULL pointer.
ERROR_INVALID_HANDLE	queueHandle is invalid. This might be occur if the queue was released in another thread or on process exit, as if by RtssKill.
ERROR_NOT_READY	RtNalInit has not completed successfully.

REMARKS

The RTND_OID field of the RTND_REQUEST structure is used to define the request type

Requirements

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