OID_SWITCH_PROPERTY_UPDATE
Граница протокола расширяемого коммутатора Hyper-V выдает запрос на набор идентификатора объекта (OID) OID_SWITCH_PROPERTY_UPDATE для уведомления расширений расширяемого коммутатора об обновлении параметров для свойства политики расширяемого коммутатора.
Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на буфер. Этот буфер содержит следующие данные:
Структура NDIS_SWITCH_PROPERTY_PARAMETERS , указывающая идентификацию и тип политики расширяемого коммутатора.
Буфер свойств, содержащий параметры для политики расширяемого коммутатора. Буфер свойств содержит структуру, основанную на элементе PropertyTypeструктуры NDIS_SWITCH_PROPERTY_PARAMETERS .
Примечание Начиная с Windows Server 2012 элемент PropertyType должен иметь значение NdisSwitchPropertyTypeCustom, а буфер свойств должен содержать NDIS_SWITCH_PROPERTY_CUSTOM структуру.
Комментарии
Расширение переадресации может обрабатывать запрос на набор OID OID_SWITCH_PROPERTY_UPDATE. Все другие типы расширений должны вызывать NdisFOidRequest , чтобы перенаправить запрос OID в следующее расширение в стеке драйвера расширяемого коммутатора.
Расширение может наказать вето на обновление свойства switch, возвращая NDIS_STATUS_DATA_NOT_ACCEPTED для запроса OID. Например, если расширение не может выделить ресурсы для применения своих обновленных политик на коммутаторе, оно должно навести вето на запрос на обновление.
Примечание Если расширение возвращает другие коды состояния ошибки NDIS_STATUS_Xxx , уведомление о создании также наложено вето. Однако возврат кодов состояния для временных сценариев, таких как возврат NDIS_STATUS_RESOURCES, может привести к повторной попытке уведомления о создании.
Если расширение не налодит вето на запрос OID, оно должно отслеживать состояние по завершении запроса. Расширение должно сделать это, чтобы определить, был ли запрос OID наложен вето базовыми расширениями в пути управления расширяемым коммутатором или интерфейсом расширяемого коммутатора.
Рекомендации по обработке запроса на набор OID OID_SWITCH_PROPERTY_UPDATE см. в статье Управление политиками переключения.
Коды состояния возврата
Если расширение завершает запрос на набор OID OID_SWITCH_PROPERTY_UPDATE, оно возвращает один из следующих кодов состояния.
| Код состояния | Описание |
|---|---|
NDIS_STATUS_DATA_NOT_ACCEPTED |
Расширение навело вето на уведомление об обновлении политики переключения. |
NDIS_STATUS_FAILURE |
Сбой запроса OID по другим причинам. |
Если расширение не завершает запрос набора OID OID_SWITCH_PROPERTY_UPDATE, запрос выполняется базовым краем минипорта расширяемого коммутатора. Ребро мини-порта возвращает следующий код состояния.
| Код состояния | Описание |
|---|---|
NDIS_STATUS_SUCCESS |
Запрос OID успешно завершен. |
Требования
Версия |
Поддерживается в NDIS 6.30 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |