OID_SWITCH_NIC_CONNECT
Пограничный протокол расширяемого коммутатора 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расширяемый порт коммутатора и состояния сетевых адаптеров.
Коды состояния возврата
Базовый краю минипорта расширяемого коммутатора завершает запрос набора OID OID_SWITCH_NIC_CONNECT и возвращает следующий код состояния.
Код состояния | Описание |
---|---|
NDIS_STATUS_SUCCESS |
Запрос OID успешно завершен. |
Требования
Версия |
Поддерживается в NDIS 6.30 и более поздних версиях. |
Заголовок |
Ntddndis.h (include Ndis.h) |