OID_SWITCH_PORT_DELETE

Статья
06/15/2023

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

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

Если сетевой адаптер подключен к указанному порту, граница протокола расширяемого коммутатора удалит подключение перед удалением порта. В этом случае перед удалением порта граничная граница протокола выполнит следующие действия:

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

На этом этапе граница протокола может начать удалять порт.

Граница протокола расширяемого коммутатора выполняет следующие действия при удалении порта расширяемого коммутатора:

Граница протокола расширяемого коммутатора выдает запрос набора OID OID_SWITCH_PORT_TEARDOWN. Этот запрос OID уведомляет базовые расширения расширяемого коммутатора о начале процесса удаления порта расширяемого коммутатора.
Пограничный протокол выдает запрос на набор OID OID_SWITCH_PORT_DELETE после завершения всех запросов OID к порту расширяемого коммутатора.

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

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

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

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

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

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

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

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

Требования

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