Share via

OID_SWITCH_NIC_DISCONNECT

  • Статья

Граница протокола расширяемого коммутатора Hyper-V выдает запрос на набор идентификатора объекта (OID) OID_SWITCH_NIC_DISCONNECT для уведомления базовых расширений расширяемого коммутатора о том, что подключение между портом расширяемого коммутатора и сетевым адаптером разрывается. После полного разрыва подключения край протокола расширяемого коммутатора выдаст запрос на набор OID OID_SWITCH_NIC_DELETE.

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

Комментарии

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

При обработке запросов на набор OID OID_SWITCH_NIC_DISCONNECT расширение должно следовать этим рекомендациям:

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

  • Запрос OID_SWITCH_NIC_DISCONNECT только уведомляет расширение о том, что подключение расширяемого коммутатора разрывается между указанным сетевым адаптером и портом расширяемого коммутатора. После того как расширение обработает этот запрос OID, оно не должно выполнять следующие действия:

    • Создайте трафик пакетов к подключению сетевого адаптера через порт расширяемого коммутатора, для которого был выдан запрос OID_SWITCH_NIC_DISCONNECT OID.

    • Вызовите ReferenceSwitchNic , чтобы увеличить счетчик ссылок расширяемого коммутатора для указанного подключения сетевого адаптера на порту расширяемого коммутатора.

    • Переадресуйте или инициируйте запросы OID OID_SWITCH_NIC_REQUEST базовому сетевому адаптеру, для которого был выдан запрос OID_SWITCH_NIC_DISCONNECT OID.

      Примечание Если расширение с именем ReferenceSwitchNic увеличивает счетчик ссылок расширяемого коммутатора до выдачи OID_SWITCH_NIC_DISCONNECT, расширение по-прежнему может перенаправлять или создавать запросы OID.

    • Переадресация или источник NDIS указывает на NDIS_STATUS_SWITCH_NIC_STATUS из базового сетевого адаптера, для которого был выдан запрос OID_SWITCH_NIC_DISCONNECT OID.

      Примечание Если расширение с именем ReferenceSwitchNic увеличивает счетчик ссылок расширяемого переключателя до выдачи OID_SWITCH_NIC_DISCONNECT, расширение по-прежнему может пересылать или создавать указания состояния NDIS.

      Примечание Если расширение ранее называлось ReferenceSwitchNic для увеличения счетчика ссылок расширяемого коммутатора, ему не нужно синхронизировать свои вызовы для создания или пересылки запросов OID или индикаторов состояния NDIS с кодом, который управляет запросами OID расширяемого коммутатора Hyper-V. После увеличения расширения счетчика ссылок интерфейс расширяемого коммутатора не будет выдавать запрос на набор OID OID_SWITCH_NIC_DELETE.

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

  • Внешний сетевой адаптер расширяемого коммутатора может быть привязан к одному или нескольким базовым физическим адаптерам. Для каждого физического сетевого адаптера, привязанного к внешнему сетевому адаптеру, граница протокола расширяемого коммутатора выдает отдельный запрос на набор OID OID_SWITCH_NIC_DISCONNECT. Каждый запрос на набор OID указывает другое значение индекса подключения сетевого адаптера. Дополнительные сведения об этих значениях индекса см. в разделе Значения индекса сетевого адаптера.

    Расширение должно поддерживать состояние подключения для каждого базового физического адаптера. Дополнительные сведения о различных конфигурациях, в которых физические сетевые адаптеры могут быть привязаны к внешнему сетевому адаптеру, см. в разделе Типы конфигураций физических сетевых адаптеров.

Примечание Расширение не должно выдавать собственные запросы набора OID OID_SWITCH_NIC_DISCONNECT.

Дополнительные сведения о состояниях портов расширяемого коммутатора и подключений к сетевым адаптерам см. в разделе Состояния расширяемого коммутатора и сетевых адаптеров Hyper-V.

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

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

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

NDIS_STATUS_SUCCESS

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

Требования

Версия

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

Заголовок

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

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

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort