структура NDIS_NDK_CONNECTIONS (ntddndis.h)

  • Статья

Структура NDIS_NDK_CONNECTIONS описывает подключения NDK, активные в адаптере мини-порта.

Синтаксис

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

Члены

Header

Структура NDIS_OBJECT_HEADER , описывающая эту NDIS_NDK_CONNECTIONS структуру. Задайте элементы структуры NDIS_OBJECT_HEADER следующим образом:

  • Задайте для элемента Typeзначение NDIS_OBJECT_TYPE_DEFAULT.
  • Задайте для элемента Редакциязначение NDIS_NDK_CONNECTIONS_REVISION_1.
  • Задайте для элемента Размер значение (USHORT)min(MAXUSHORT, NDIS_SIZEOF_NDK_CONNECTIONS_REVISION_1(n)).

Flags

Count

Количество элементов в массиве соединений, передаваемых в элементе Connections. Каждый элемент в массиве является NDIS_NDK_CONNECTION_ENTRY структурой.

NDConnectionsMappedtoTCPConnections

Значение BOOLEAN, указывающее способ сопоставления подключений. Если технология RDMA для поставщика NDK требует, чтобы поставщик сопоставлял подключения ND с TCP-подключениями, поставщик NDK должен задать для элемента NDConnectionsMappedtoTCPConnections значение TRUE. В противном случае NDConnectionsMappedtoTCPConnections имеет значение FALSE.

Connections[1]

Массив переменных размеров NDIS_NDK_CONNECTION_ENTRY структур, в которых размер массива определяется количеством возвращаемых подключений. Элемент Count указывает количество элементов в массиве соединений.

Комментарии

Структура NDIS_NDK_CONNECTIONS возвращается с идентификатором OID_NDK_CONNECTIONS . Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на эту структуру.

Эта структура имеет переменный размер и содержит элементы, равные числу возвращаемых соединений. Фактический размер массива соединений в качестве количества элементов обозначается элементом Count .

Если технология RDMA для поставщика NDK требует, чтобы поставщик сопоставил подключения ND с TCP-подключениями, поставщик NDK также должен сообщить базовый кортеж TCP-подключения 4 для каждого подключения ND следующим образом:

  • Задайте для элемента NDConnectionsMappedtoTCPConnections значение TRUE.
  • Используйте две последовательные записи для каждого подключения ND. Первая запись содержит сведения об адресации ND (локальный и удаленный IP-адрес и номер порта ND), а следующая запись содержит сведения об адресации соответствующего TCP-подключения (локальный и удаленный IP-адрес и номер TCP-порта).
  • Элементы, отличные от сведений об адресации (например, UserModeOwner и OwnerPid), должны быть заданы только в первой записи и оставлены нетронутыми в следующей записи. Таким образом, записи с индексами 0, 2, 4 и т. д. содержат сведения об адресации ND (а также правильно заполнены другими элементами), а записи с индексами 1, 3, 5 и т. д. содержат сведения об адресации TCP (где другие члены остаются нетронутыми).

Требования

Требование Значение
Минимальная версия клиента Не поддерживается, поддерживается в NDIS 6.30 и более поздних версиях.
Минимальная версия сервера Windows Server 2012
Верхняя часть ntddndis.h (включая Ndis.h)

См. также раздел

NDIS_NDK_CONNECTION_ENTRY

NDIS_OBJECT_HEADER

OID_NDK_CONNECTIONS