Share via

OID_SWITCH_PORT_CREATE

  • Статья

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

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

Комментарии

Элемент PortId структуры NDIS_SWITCH_PORT_PARAMETERS указывает порт, для которого создается уведомление о создании.

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

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

  • Расширение может наказать вето на уведомление о создании, возвращая NDIS_STATUS_DATA_NOT_ACCEPTED для запроса OID. Например, если расширению не удается выделить ресурсы для применения настроенных политик на порту, драйвер должен навести вето на уведомление о создании.

    Если расширение возвращает другие коды состояния ошибки NDIS_STATUS_Xxx , уведомление о создании также наложено вето. Однако возврат кодов состояния для временных сценариев, таких как возврат NDIS_STATUS_RESOURCES, может привести к повторной попытке уведомления о создании.

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

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

  • Если расширение вызывает NdisFOidRequest для пересылки этого запроса на набор OID, расширение должно отслеживать состояние завершения этого запроса OID. Расширение делает это, чтобы определить, наложили ли вето базовые расширения в стеке драйверов расширяемого коммутатора на уведомление о создании порта.

  • После успешного перенаправления и завершения запроса OID расширение может выдавать запросы OID для порта, например OID_SWITCH_PORT_PROPERTY_ENUM, пока не будет выдан запрос OID OID_SWITCH_PORT_TEARDOWN . Этот запрос OID уведомляет расширение о том, что порт начнет процесс удаления из расширяемого коммутатора.

  • Расширения не могут пересылать пакеты на указанный порт в структуре NDIS_SWITCH_PORT_PARAMETERS до тех пор, пока не будет успешно выполнен запрос на набор OID OID_SWITCH_NIC_CONNECT .

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

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

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

Если расширение завершает запрос на набор OID OID_SWITCH_PORT_CREATE, оно возвращает один из следующих кодов состояния.

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

NDIS_STATUS_DATA_NOT_ACCEPTED

Расширение навело вето на уведомление о создании.

NDIS_STATUS_RESOURCES

Расширение наложено вето на уведомление о создании из-за нехватки ресурсов.

NDIS_STATUS_Xxx

Расширение наложено вето на уведомление о создании по другим причинам.

Примечание Если расширение завершает запрос набора OID, оно не должно возвращать NDIS_STATUS_SUCCESS.

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

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

NDIS_STATUS_SUCCESS

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

Требования

Версия

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

Заголовок

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

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

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_CONNECT

OID_SWITCH_PORT_ARRAY

OID_SWITCH_PORT_PROPERTY_ENUM