структура 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
Количество элементов в массиве соединений, передаваемых в элементе подключений. Каждый элемент в массиве представляет собой NDIS_NDK_CONNECTION_ENTRY структуру.
NDConnectionsMappedtoTCPConnections
ЛОГИЧЕСКОЕ значение, указывающее, как сопоставляются подключения. Если для поставщика NDK требуется, чтобы поставщик сопоставлял подключения ND с TCP-подключениями, поставщик NDK должен задать NDConnectionsMappedtoTCPConnections с значением TRUE. В противном случае NDConnectionsMappedtoTCPConnections равно FALSE.
Connections[1]
Массив переменных размеров NDIS_NDK_CONNECTION_ENTRY структур, в которых размер массива определяется числом возвращаемых подключений. Элемент счетчика указывает количество элементов в массиве соединений.
Замечания
Структура NDIS_NDK_CONNECTIONS возвращается с помощью OID_NDK_CONNECTIONS OID. Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на эту структуру.
Эта структура имеет переменный размер и содержит элементы, равные числу возвращаемых подключений. Фактический размер массива соединений в качестве количества элементов указывается элементом Count.
Если для поставщика 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 (include Ndis.h) |