RTN_FN_SETDATALONG

RTN_FN_SETDATALONG is a pointer to an application function that stores in the value placed at offset index in the application context. This value can be later retrieved by the device driver by calling RtnGetDataLong, which will in turn call the application function RTN_FN_GETDATALONG.

Syntax

VOID (*RTN_FN_SETDATALONG)(
	PVOID pAppContext,
	LONG offset,
	ULONG long value
);

Parameters

pAppContext

Application context pointer used as an argument in RtNalConfigureQueue.

offset

Offset of data to retrieve. The range is application specific.

value

Value to store.

Return Value

None

Remarks

If an application callback RTN_FN_SETDATALONG was supplied in RtNalConfigureQueue, it is called in RtNalConfigureQueue with the offset 0 and 1 to store the index of the device driver instance and the device queue index in the application context data area.

RTN_FN_SETDATALONG is called from RtnSetDataLong in a device driver with the offset greater than 1.

Offset 0 is reserved to identify the device driver instance from the network pointer passed to a RTND API function.

Offset 1 is reserved to identify the device queue number from the network pointer passed to a RTND API function.

Requirements

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