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

  • Статья

Структура 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. Задайте для элемента Type структуры, указанной в заголовке , значение NDIS_OBJECT_TYPE_OPEN_PARAMETERS, для элемента Revision — NDIS_OPEN_PARAMETERS_REVISION_1, а для элемента Size — NDIS_SIZEOF_OPEN_PARAMETERS_REVISION_1.

AdapterName

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

MediumArray

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

MediumArraySize

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

SelectedMediumIndex

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

FrameTypeArray

Указатель на массив NET_FRAME_TYPE значений, указывающий типы кадров, которые требуется получить драйверу протокола. Тип кадра — это значение USHORT, следующее за целевым и исходным MAC-адресом в кадрах Ethernet. При наличии тегов виртуальной ЛС это значение следует за назначением, исходным 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 (включая Ndis.h)

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

NDIS_MEDIUM

NDIS_OBJECT_HEADER

NdisOpenAdapterEx

ProtocolBindAdapterEx