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_SWITCH_PORT_PROPERTY_CUSTOM
NDIS_SWITCH_PORT_PROPERTY_PARAMETERS