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 (include Ndis.h) |