OID_SWITCH_PORT_PROPERTY_ADD

Статья
03/13/2025

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

Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на буфер. Этот буфер содержит следующие данные:

Структура NDIS_SWITCH_PORT_PROPERTY_PARAMETERS, указывающая идентификацию и тип параметров политики портов.
Буфер свойств, содержащий параметры политики портов. Буфер свойств содержит структуру, основанную на элементе PropertyType структуры NDIS_SWITCH_PORT_PROPERTY_PARAMETERS. Например, если для элемента PropertyType задано значение NdisSwitchPortPropertyTypeVlan, буфер свойств содержит структуру NDIS_SWITCH_PORT_PROPERTY_VLAN.

Замечания

Расширение пересылки может обрабатывать запрос набора OID OID_SWITCH_PORT_PROPERTY_ADD. Все остальные типы расширений должны вызывать NdisFOidRequest для пересылки запроса OID в следующее расширение в стеке расширяемого драйвера коммутатора.

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

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

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

Рекомендации по обработке запроса набора OID OID_SWITCH_PORT_PROPERTY_ADD см. в управлении политиками портов.

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

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

Код состояния	Описание
NDIS_STATUS_INVALID_LENGTH	Длина буфера информации слишком мала, чтобы обработать структуру NDIS_SWITCH_PORT_PROPERTY_PARAMETERS и данные в буфере свойств структуры. Расширение задает DATA. SET_INFORMATION. Элемент BytesNeeded в структуре NDIS_OID_REQUEST к минимальному размеру буфера, который требуется.
NDIS_STATUS_DATA_NOT_ACCEPTED	Расширение пересылки вето на уведомление о добавлении политики портов.
NDIS_STATUS_NOT_SUPPORTED	Расширение пересылки не поддерживает политику порта.
NDIS_STATUS_Xxx	Запрос OID завершился сбоем по другим причинам.

Если расширение не завершает запрос набора OID OID_SWITCH_PORT_PROPERTY_ADD, запрос завершается базовым краем минипорта расширяемого коммутатора. Минипорт возвращает следующий код состояния: