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