OID_SWITCH_NIC_UPDATED

Граница протокола расширяемого коммутатора Hyper-V выдает запрос на набор идентификатора объекта (OID) OID_SWITCH_NIC_UPDATED в стек драйвера расширяемого коммутатора. Этот запрос OID уведомляет базовые расширения расширяемого коммутатора об обновлении параметров сетевого адаптера. OID будет выдан только для сетевых адаптеров, которые уже подключены и еще не начали процесс отключения. Эти изменения конфигурации во время выполнения могут включать NicFriendlyName, NetCfgInstanceId, MTU, NumaNodeId, PermanentMacAddress, VMMacAddress, CurrentMacAddress и VFAssigned.

Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на NDIS_SWITCH_NIC_PARAMETERS структуру.

Комментарии

Элемент PortId структуры NDIS_SWITCH_NIC_PARAMETERS указывает порт, для которого создается уведомление об обновлении. Расширение расширяемого коммутатора может получить сведения о параметрах для этого и других портов расширяемого коммутатора, отправляя запросы OID OID_SWITCH_PORT_ARRAY.

Элемент Index структуры NDIS_SWITCH_NIC_PARAMETERS указывает индекс сетевого адаптера, для которого создается уведомление об обновлении. Сетевой адаптер с указанным значением Index подключается к порту расширяемого коммутатора, заданному элементом PortId . Дополнительные сведения об этих значениях индекса см. в разделе Значения индекса сетевого адаптера.

Расширение должно соответствовать следующим рекомендациям по обработке запросов на набор OID OID_SWITCH_NIC_UPDATED:

  • Расширение не должно изменять структуру NDIS_SWITCH_NIC_PARAMETERS , связанную с запросом OID.
  • Расширение всегда должно пересылать этот запрос набора OID в базовые расширения. Расширение не должно выполнять запрос.
  • Расширение не должно выдавать собственные запросы на набор OID OID_SWITCH_NIC_UPDATED.

Коды состояния возврата

Базовая граница мини-порта расширяемого коммутатора завершает запрос OID OID_SWITCH_NIC_UPDATED и возвращает следующий код состояния.

Код состояния Описание

NDIS_STATUS_SUCCESS

Запрос OID успешно завершен.

Требования

Версия

Поддерживается в NDIS 6.30 и более поздних версиях.

Заголовок

Ntddndis.h (включая Ndis.h)

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


DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_PORT_ARRAY

ReferenceSwitchNic