OID_SWITCH_NIC_CONNECT

Статья
03/13/2025

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

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

Замечания

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

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

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

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

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

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

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

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