Share via

OID_SWITCH_PORT_PROPERTY_UPDATE

  • Статья

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

Элемент 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_UPDATE. Все другие типы расширений должны вызывать NdisFOidRequest , чтобы перенаправить запрос OID в следующее расширение в стеке драйвера расширяемого коммутатора.

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

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

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

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

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

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

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

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

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

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