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

Статья
05/23/2024

Структура NDIS_SWITCH_NIC_OID_REQUEST указывает сведения, необходимые для пересылки или создания запросов OID.

Синтаксис

typedef struct _NDIS_SWITCH_NIC_OID_REQUEST {
  NDIS_OBJECT_HEADER    Header;
  ULONG                 Flags;
  NDIS_SWITCH_PORT_ID   SourcePortId;
  NDIS_SWITCH_NIC_INDEX SourceNicIndex;
  NDIS_SWITCH_PORT_ID   DestinationPortId;
  NDIS_SWITCH_NIC_INDEX DestinationNicIndex;
  PNDIS_OID_REQUEST     OidRequest;
} NDIS_SWITCH_NIC_OID_REQUEST, *PNDIS_SWITCH_NIC_OID_REQUEST;

Члены

Header

Тип, редакция и размер структуры NDIS_SWITCH_NIC_OID_REQUEST . Этот элемент отформатирован как структура NDIS_OBJECT_HEADER .

Для элемента Typeзаголовка необходимо задать значение NDIS_OBJECT_TYPE_DEFAULT. Чтобы указать версию структуры NDIS_SWITCH_NIC_OID_REQUEST , член редакциизаголовка должен иметь следующее значение:

NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1

Исходная версия для NDIS 6.30 и более поздних версий.

Задайте для элемента Размер значение NDIS_SIZEOF_NDIS_SWITCH_NIC_OID_REQUEST_REVISION_1.

Flags

Значение ULONG, содержащее побитовое ИЛИ флагов. Этот элемент зарезервирован для NDIS.

SourcePortId

Значение NDIS_SWITCH_PORT_ID, содержащее уникальный идентификатор порта расширяемого коммутатора Hyper-V, к которому изначально был выдан запрос OID.

SourceNicIndex

Значение NDIS_SWITCH_NIC_INDEX, указывающее индекс исходного сетевого адаптера, подключенного к порту расширяемого коммутатора источника, указанному элементом SourcePortId .

DestinationPortId

Значение NDIS_SWITCH_PORT_ID, содержащее уникальный идентификатор порта расширяемого коммутатора, на который должен быть переадресован запрос OID.

DestinationNicIndex

Значение NDIS_SWITCH_NIC_INDEX, указывающее индекс сетевого адаптера назначения, подключенного к порту расширяемого коммутатора, указанному элементом DestinationPortId .

OidRequest

Указатель на структуру NDIS_OID_REQUEST . Эта структура содержит данные для запроса OID, который будет пересылаться драйверу мини-порта сетевого адаптера, указанного членами DestinationPortId и DestinationNicIndex .

Расширение может пересылать или создавать запросы OID к базовым физическим сетевым адаптерам в стеке драйвера расширяемого коммутатора. Это позволяет расширению выполнять следующие действия:

Управление конфигурацией разгрузки оборудования на базовом физическом адаптере для следующих технологий разгрузки:
- Безопасность протокола IP (IPsec).
- Виртуализированная очередь машин (VMQ).
- Виртуализация SR-IOV.
Запрос конфигурации базового физического сетевого адаптера путем выдачи стандартных идентификаторов NDIS OID. Например, расширение может выдать запрос OID OID_802_3_CURRENT_ADDRESS для получения текущего MAC-адреса адаптера.

Рекомендации по отправке запросов OID к базовым физическим адаптерам см. в разделе Управление запросами OID к физическим сетевым адаптерам.

Требования

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

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

NDIS_OBJECT_HEADER

NDIS_OID_REQUEST

OID_SWITCH_NIC_REQUEST

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