Share via

OID_SWITCH_PORT_PROPERTY_ADD

  • Статья

Граница протокола расширяемого коммутатора 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 в следующее расширение в стеке драйвера расширяемого коммутатора.

Расширение может наложение вето на добавление свойства port, возвращая 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, запрос выполняется базовым краем минипорта расширяемого коммутатора. Ребро мини-порта возвращает следующий код состояния:

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

NDIS_STATUS_SUCCESS

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

Требования

Версия

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

Заголовок

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

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

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PROPERTY_CUSTOM

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS

NDIS_SWITCH_PORT_PROPERTY_VLAN

NdisFOidRequest