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


OID_SWITCH_NIC_DELETE

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

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

Замечания

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

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

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

Примечание Если расширение добавило счетчик ссылок расширяемого коммутатора для сетевого адаптера путем вызова ReferenceSwitchNic, запрос OID_SWITCH_NIC_DELETE не выдан, пока счетчик ссылок не является ненулевой. Расширение уменьшает счетчик ссылок расширяемого коммутатора путем вызова DereferenceSwitchNic.

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

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

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

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

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

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

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

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

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

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

NDIS_STATUS_SUCCESS

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

Требования

Версия

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

Заголовок

Ntddndis.h (include Ndis.h)

См. также


DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_PORT_ARRAY

ReferenceSwitchNic