OID_SWITCH_PORT_PROPERTY_UPDATE
Hyper-V 可扩展交换机的协议边缘发出对象标识符 (OID) OID_SWITCH_PORT_PROPERTY_UPDATE集请求,以通知可扩展交换机扩展有关可扩展交换机端口策略的属性更新。
NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向缓冲区的指针。 此缓冲区包含以下数据:
一个NDIS_SWITCH_PORT_PROPERTY_PARAMETERS结构,用于指定端口属性的标识和类型。
一个属性缓冲区,其中包含端口策略的参数。 属性缓冲区包含基于 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 结构的 PropertyType 成员的结构。 例如,如果 PropertyType 成员设置为 NdisSwitchPortPropertyTypeVlan,则属性缓冲区包含 NDIS_SWITCH_PORT_PROPERTY_VLAN 结构。
注解
转发扩展可以处理OID_SWITCH_PORT_PROPERTY_UPDATE的 OID 集请求。 所有其他类型的扩展都必须调用 NdisFOidRequest ,以将 OID 请求转发到可扩展交换机驱动程序堆栈中的下一个扩展。
扩展可以通过返回 OID 请求的NDIS_STATUS_DATA_NOT_ACCEPTED来否决端口属性的更新。 例如,如果扩展无法分配资源以在端口上强制执行其更新的策略,则应否决更新请求。
注意 如果扩展返回其他 NDIS_STATUS_Xxx 错误状态代码,则更新通知也会被否决。 但是,返回临时方案的状态代码(例如返回NDIS_STATUS_RESOURCES)可能会导致重试创建通知。
如果扩展未否决 OID 请求,则应在请求完成时监视状态。 扩展应执行此操作以确定 OID 请求是由可扩展交换机控制路径中的基础扩展还是由可扩展交换机接口否决。
有关如何处理OID_SWITCH_PORT_PROPERTY_UPDATE的 OID 集请求的指南,请参阅 管理端口策略。
返回状态代码
如果转发扩展完成 OID_SWITCH_PORT_PROPERTY_UPDATE 的 OID 集请求,则返回以下状态代码之一。
状态代码 | 说明 |
---|---|
NDIS_STATUS_INVALID_LENGTH |
信息缓冲区的长度太小,无法处理 NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 结构和结构属性缓冲区中的数据。 扩展设置 DATA。SET_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。 |
NDIS_STATUS_DATA_NOT_ACCEPTED |
转发扩展已否决端口策略删除通知。 |
NDIS_STATUS_NOT_SUPPORTED |
转发扩展不支持端口策略。 |
NDIS_STATUS_Xxx |
OID 请求由于其他原因而失败。 |
如果扩展未完成 OID_SWITCH_PORT_PROPERTY_UPDATE 的 OID 集请求,则请求由可扩展交换机的基础微型端口边缘完成。 微型端口边缘返回以下状态代码。
状态代码 | 说明 |
---|---|
NDIS_STATUS_SUCCESS |
OID 请求已成功完成。 |
要求
版本 |
在 NDIS 6.30 及更高版本中受支持。 |
标头 |
Ntddndis.h (包括 Ndis.h) |
另请参阅
NDIS_SWITCH_PORT_PROPERTY_CUSTOM
NDIS_SWITCH_PORT_PROPERTY_PARAMETERS