OID_SWITCH_PROPERTY_ADD
Граница протокола расширяемого коммутатора Hyper-V выдает запрос на набор идентификатора объекта (OID) OID_SWITCH_PROPERTY_ADD для уведомления расширений расширяемого коммутатора о добавлении свойства политики коммутатора.
Элемент 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_ADD. Все остальные типы расширений должны вызывать NdisFOidRequest для пересылки запроса OID к следующему расширению в стеке драйвера расширяемого коммутатора.
Расширение может наключить вето на добавление свойства switch, возвращая NDIS_STATUS_DATA_NOT_ACCEPTED для запроса OID. Например, если расширение не может выделить ресурсы для принудительного применения обновленных политик на коммутаторе, оно должно наказать вето на запрос на добавление.
Примечание Если расширение возвращает другие коды состояния ошибок NDIS_STATUS_Xxx , уведомление о создании также наложено вето. Однако возврат кодов состояния для временных сценариев, таких как возврат NDIS_STATUS_RESOURCES, может привести к повторной попытке уведомления о создании.
Если расширение не налонит вето на запрос OID, оно должно отслеживать состояние по завершении запроса. Расширение должно сделать это, чтобы определить, был ли наложен вето на запрос OID базовыми расширениями в пути управления расширяемым коммутатором или интерфейсом расширяемого коммутатора.
Рекомендации по обработке запроса на набор OID для OID_SWITCH_PROPERTY_ADD см. в разделе Управление политиками переключения.
Коды состояния возврата
Если расширение переадресации завершает запрос на набор OID OID_SWITCH_PROPERTY_ADD, оно возвращает один из следующих кодов состояния.
| Код состояния | Описание |
|---|---|
NDIS_STATUS_DATA_NOT_ACCEPTED |
Расширение налоло вето на уведомление о добавлении политики переключения. |
NDIS_STATUS_FAILURE |
Запрос OID завершился сбоем по другим причинам. |
Если расширение не завершает запрос набора OID OID_SWITCH_PROPERTY_ADD, запрос выполняется базовым краем мини-порта расширяемого коммутатора. Ребро мини-порта возвращает следующий код состояния.
| Код состояния | Описание |
|---|---|
NDIS_STATUS_SUCCESS |
Запрос OID успешно завершен. |
Требования
Версия |
Поддерживается в NDIS 6.30 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |