OID_SWITCH_NIC_DELETE

  • Статья

Граница протокола расширяемого коммутатора Hyper-V выдает запрос на набор идентификатора объекта (OID) OID_SWITCH_NIC_DELETE в стек драйвера расширяемого коммутатора. Этот запрос OID уведомляет базовые расширения расширяемого коммутатора об удалении соединения между портом расширяемого коммутатора и сетевым адаптером. Край протокола расширяемого коммутатора ранее уведомлял расширения о том, что это подключение удаляется при выдаче запроса на набор OID OID_SWITCH_NIC_DISCONNECT.

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

Комментарии

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

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

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

Примечание Если расширение увеличивает расширяемый счетчик ссылок на коммутатор для сетевого адаптера путем вызова ReferenceSwitchNic, запрос OID_SWITCH_NIC_DELETE не выдается, пока счетчик ссылок не равен нулю. Расширение уменьшает счетчик ссылок расширяемого коммутатора, вызывая DereferenceSwitchNic.

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

  • Расширение не должно изменять структуру NDIS_SWITCH_NIC_PARAMETERS , связанную с запросом OID.

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

  • Расширение не должно выдавать собственные запросы набора OID OID_SWITCH_NIC_DELETE.

  • Внешний сетевой адаптер расширяемого коммутатора может быть привязан к одному или нескольким базовым физическим адаптерам. Для каждого физического сетевого адаптера, привязанного к внешнему сетевому адаптеру, ребро протокола расширяемого коммутатора выдает отдельный запрос на набор OID OID_SWITCH_NIC_DELETE. Каждый запрос на набор OID указывает другое значение индекса подключения сетевого адаптера. Дополнительные сведения об этих значениях индекса см. в разделе Значения индекса сетевого адаптера.

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

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

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

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

Код состояния Описание

NDIS_STATUS_SUCCESS

Запрос OID успешно завершен.

Требования

Версия

Поддерживается в NDIS 6.30 и более поздних версиях.

Заголовок

 Ntddndis.h (включая Ndis.h)

См. также раздел

DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_PORT_ARRAY

ReferenceSwitchNic