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, он возвращает один из следующих кодов состояния.

Если расширение не завершает запрос набора OID OID_SWITCH_PROPERTY_ADD, запрос завершается базовым краем минипорта расширяемого коммутатора. Минипорт возвращает следующий код состояния.

Требования

См. также

NDIS_OID_REQUEST

NDIS_SWITCH_PROPERTY_CUSTOM

NDIS_SWITCH_PROPERTY_PARAMETERS

NdisFOidRequest