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


OID_SWITCH_NIC_DISCONNECT

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

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

Замечания

Элемент индекса структуры 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 с кодом, который управляет Hyper-V расширяемыми запросами OID. После увеличения расширения счетчик ссылок интерфейс расширяемого коммутатора не выдает запрос набора 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 (include Ndis.h)

См. также


NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort