RtnGetDataLong

RtnGetDataLong retrieves the value placed at offset index of the network device pointed to by ndp.

Syntax

unsigned
long
RtnGetDataLong(
    void *ndp,
    long offset
);

Parameters

ndp

Network Device Pointer. Opaque network device identifier (pointer).

offset

Offset of data to retrieve. This is an index of 0 through 7.

Return Value

Value placed in offset index of network device pointed to by ndp.

Remarks

RtnSetDataLong and RtnGetDataLong allow the driver writer to save driver specific data in the network device data structure. Up to 8 data elements of 32 bits (4 bytes) each may be saved in the ndp structure. These DWORDs may be accessed by using the Offset index 0 through 7 in RtnSetDataLong and RtnGetDataLong.

RtnGetDataLong is normally used in RTND functions that are passed a network device pointer to identify the particular driver instance. Normally, index 0 is used to store the index (or pointer) to the local driver configuration structure initialized in RtndInitialize and RtndConfigure. This allows a single driver to support multiple NICs simultaneously. Each instance of a driver (and NIC) will have its own network device data structure.

Requirements

Minimum Supported Version	RTX64 2013
Header	rtnapi.h
Library	RtTcpip.lib