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) |