NDIS_NDK_CONNECTIONS structure (ntddndis.h)

The NDIS_NDK_CONNECTIONS structure describes the NDK connections that are active on a miniport adapter.

Syntax

typedef struct _NDIS_NDK_CONNECTIONS {
  NDIS_OBJECT_HEADER        Header;
  ULONG                     Flags;
  ULONG                     Count;
  BOOLEAN                   NDConnectionsMappedtoTCPConnections;
  NDIS_NDK_CONNECTION_ENTRY Connections[1];
} NDIS_NDK_CONNECTIONS;

Members

Header

An NDIS_OBJECT_HEADER structure that describes this NDIS_NDK_CONNECTIONS structure. Set the members of the NDIS_OBJECT_HEADER structure as follows:

• Set the Type member to NDIS_OBJECT_TYPE_DEFAULT.
• Set the Revision member to NDIS_NDK_CONNECTIONS_REVISION_1.
• Set the Size member to (USHORT)min(MAXUSHORT, NDIS_SIZEOF_NDK_CONNECTIONS_REVISION_1(n)).

Flags

Count

The number of elements in the connection array that is passed in the Connections member. Each element in the array is an NDIS_NDK_CONNECTION_ENTRY structure.

NDConnectionsMappedtoTCPConnections

A BOOLEAN value that specifies how the connections are mapped. If the RDMA technology for the NDK provider requires the provider to map ND connections to TCP connections, the NDK provider must set the NDConnectionsMappedtoTCPConnections member to TRUE. Otherwise, NDConnectionsMappedtoTCPConnections is FALSE.

Connections[1]

A variable-sized array of NDIS_NDK_CONNECTION_ENTRY structures where the size of the array is determined by the number of connections being returned. The Count member specifies the number of elements in the connection array.

Remarks

The NDIS_NDK_CONNECTIONS structure is returned with the OID_NDK_CONNECTIONS OID. The InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to this structure.

This structure is variable-sized and contains elements equal in number to the number of connections that are returned. The actual size of the connection array as an element count is indicated by the Count member.

If the RDMA technology for the NDK provider requires the provider to map ND connections to TCP connections, the NDK provider must also report the underlying TCP connection 4-tuple for each ND connection as follows:

• Set the NDConnectionsMappedtoTCPConnections member to TRUE.
• Use two consecutive entries for each ND connection. The first entry contains the ND addressing information (local and remote IP address, and ND port number) and the immediate next entry contains the corresponding TCP connection's addressing information (local and remote IP address, and TCP port number).
• Members other than addressing information (For example, UserModeOwner and OwnerPid) must be set only in the first entry and left untouched in the next entry. Therefore, entries at index 0, 2, 4, and so on, contain ND addressing information (plus properly filled-in other members) and entries at index 1, 3, 5 and so on, contain TCP addressing info (where other members are left untouched).

Requirements

See also

NDIS_NDK_CONNECTION_ENTRY

NDIS_OBJECT_HEADER

OID_NDK_CONNECTIONS