OID_SWITCH_PORT_CREATE

Статья
2025-03-13

Пограничный протокол расширяемого коммутатора 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.