структура NDIS_OPEN_PARAMETERS (ndis.h)

Статья
02/07/2025

Структура NDIS_OPEN_PARAMETERS определяет открытые параметры, когда драйвер протокола вызывает функцию NdisOpenAdapterEx.

Синтаксис

typedef struct _NDIS_OPEN_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  PNDIS_STRING       AdapterName;
  PNDIS_MEDIUM       MediumArray;
  UINT               MediumArraySize;
  PUINT              SelectedMediumIndex;
  PNET_FRAME_TYPE    FrameTypeArray;
  UINT               FrameTypeArraySize;
} NDIS_OPEN_PARAMETERS, *PNDIS_OPEN_PARAMETERS;

Члены

Header

Структура NDIS_OBJECT_HEADER для структуры NDIS_OPEN_PARAMETERS. Задайте элемент типа структуры, которая заголовка указывает NDIS_OBJECT_TYPE_OPEN_PARAMETERS, элемент редакции NDIS_OPEN_PARAMETERS_REVISION_1 и член размера NDIS_SIZEOF_OPEN_PARAMETERS_REVISION_1.

AdapterName

Строка Юникода, содержащая имя минипорта адаптера, переданного NDIS ProtocolBindAdapterExв элементе adapterName параметра BindParameters. Это имя может определить физический адаптер (то есть сетевой адаптер) или виртуальный адаптер, связанный с промежуточным драйвером.

MediumArray

Указатель на массив значений NdisMediumXxx, которые перечисляют типы носителей, которые вызывающий объект может поддерживать. Этот список представляет собой подмножество типов NDIS_MEDIUM.

MediumArraySize

Количество элементов в элементе MediumArra y.

SelectedMediumIndex

Указатель на указанную драйвером переменную UINT, содержащую индекс в массиве MediumArray. NDIS записывает этот индекс, определяющий тип носителя, который использует базовый драйвер.

FrameTypeArray

Указатель на массив значений NET_FRAME_TYPE, указывающий типы кадров, которые требуется получить драйвер протокола. Тип кадра — это значение USHORT, которое следует целевому и исходному MAC-адресу в кадрах Ethernet. В присутствии тегов VLAN это значение следует целевому, исходному MAC-адресу и тегу виртуальной локальной сети. NET_FRAME_TYPE определяется следующим образом:

typedef USHORT  NET_FRAME_TYPE;
typedef NET_FRAME_TYPE *PNET_FRAME_TYPE;

Примечание NDIS использует значения типов кадров, которые драйвер протокола предоставляет в этом массиве в качестве указания для оптимизации показателей получения, которые NDIS отправляет драйверу протокола. NDIS не гарантирует, что драйвер протокола получит только пакеты с типами кадров, которые соответствуют типам в массиве.

FrameTypeArraySize

Количество элементов элемента FrameTypeArray. Это число должно быть равно или меньше NDIS_MAX_FRAME_TYPES_PER_OPEN.

Замечания

Драйвер протокола передает структуру NDIS_OPEN_PARAMETERS при вызове функции NdisOpenAdapterEx для открытия мини-адаптера.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.0 и более поздних версиях.
заголовка	ndis.h (include Ndis.h)

См. также

NDIS_MEDIUM

NDIS_OBJECT_HEADER

NdisOpenAdapterEx

ProtocolBindAdapterEx

Поделиться через