OID_SWITCH_PORT_TEARDOWN

Статья
07/08/2024

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

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

Замечания

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

Путем выдачи запросов OID OID_SWITCH_PORT_ARRAY. Расширение выдает этот идентификатор OID в FilterAttach, только если OID_SWITCH_PARAMETERS возвращает структуру NDIS_SWITCH_PARAMETERS с параметром IsActive с значением TRUE. Если значение IsActive равно FALSE, расширение выдает идентификатор OID, если NET_PNP_EVENT NetEventSwitchActivate выдает мини-порт расширения.
Проверяя различные наборы OID-запросов OID_SWITCH_PORT_CREATE и OID_SWITCH_PORT_DELETE.

Пограничный протокол расширяемого коммутатора выдает запрос набора OID OID_SWITCH_PORT_TEARDOWN для уведомления расширения о том, что порт находится в процессе удаления из расширяемого коммутатора. До выдачи этого запроса OID пограничный протокол расширяемого коммутатора ранее выпустил следующие OID, если порт имел активное подключение сетевого адаптера:

OID_SWITCH_NIC_DISCONNECT, который уведомил базовые расширения о том, что сетевой адаптер больше не подключен к порту, указанному в структуре NDIS_SWITCH_PORT_PARAMETERS.
OID_SWITCH_NIC_DELETE, который уведомил базовые расширения о том, что сетевое подключение между сетевым адаптером и расширяемым портом коммутатора было удалено.

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

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

Примечание. Расширение увеличивает счетчик ссылок для расширяемого порта коммутатора путем вызова ReferenceSwitchPort. Расширение уменьшает счетчик ссылок путем вызова DereferenceSwitchPort.

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

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

Примечание. Расширение не должно изменять структуру NDIS_SWITCH_PORT_PARAMETERS , связанную с запросом OID.
После перенаправления этого запроса OID расширение не может пересылать пакеты в удаленный порт. Расширение также не может выдавать запросы OID и не вызывать функцию ReferenceSwitchPort для удаленного порта.

Обратите внимание , что расширение не должно выдавать запросы набора OID OID_SWITCH_PORT_TEARDOWN.

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

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

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

Код состояния	Description
NDIS_STATUS_SUCCESS	Запрос OID успешно завершен.

Требования

Версия	Поддерживается в NDIS 6.30 и более поздних версиях.
Верхний колонтитул	Ntddndis.h (include Ndis.h)