RtNalSetInterruptModeration

RtNalSetInterruptModeration sets the interrupt moderation (throttling) interval.

Syntax

BOOL RtNalSetInterruptModeration(
	RTNAL_QUEUE_HANDLE queueHandle,
	ULONG interval
);

Parameters

queueHandle

The receive queue handle returned by RtNalAcquireQueue.

interval

The moderation interval in nanoseconds. This is the minimum guaranteed time between receive/transmit interrupts.

Return Value

Returns TRUE if the function 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 setting interrupt moderation.
ERROR_INVALID_HANDLE	The argument queueHandle is invalid.
ERROR_INVALID_PARAMETER	queueHandle or pHardwareTimeStamps is a NULL pointer or interval is out of range.
ERROR_NOT_READY	RtNalInit has not completed successfully.

Remarks

For a list of supported functions for specific drivers, see Matrix of Supported Real-Time NAL Functions by NIC Driver.

The caller must provide a valid interval. Note that interval range is NIC-specific.

While accepting a queue handle, this API is not queue specific and queue is only needed to identify the precise NIC driver to access. There is no interrupt moderation per queue.

The RtNalE1000 driver does not support this function.

Requirements

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