OID_SWITCH_PORT_PROPERTY_ENUM
Hyper-V 可扩展交换机扩展发出对象标识符 (OID) OID_SWITCH_PORT_PROPERTY_ENUM 方法请求以获取数组。 此数组包含与指定条件匹配的预配端口策略。 数组中的每个元素为指定的可扩展交换机端口指定策略的属性。
NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向缓冲区的指针。 此缓冲区包含以下数据:
一个NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS结构,用于指定指定端口的策略枚举的参数。
NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 结构的数组。 其中每个结构都包含有关可扩展交换机端口策略的属性的信息。
注意如果 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 结构的 NumProperties 成员设置为零,则不返回NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO结构。
注解
在发出OID_SWITCH_PORT_PROPERTY_ENUM的 OID 方法请求之前,可扩展开关扩展必须遵循以下准则:
扩展只能在可扩展交换机的协议边缘发出OID_SWITCH_PORT_CREATE请求之后以及发出 OID_SWITCH_PORT_TEARDOWN 请求之前发出 OID_SWITCH_PORT_PROPERTY_ENUM 请求。
扩展必须在调用 NdisFOidRequest 以发出OID_SWITCH_PORT_PROPERTY_ENUM请求之前调用 ReferenceSwitchPort。 这可确保在 OID 请求完成之前不会删除指定的端口。
完成 OID 请求后,扩展必须调用 DereferenceSwitchPort。 无论 OID 请求是否使用 NDIS_STATUS_SUCCESS 完成,扩展都必须调用此函数。
仅当 Hyper-V 可扩展交换机完成激活时,才能发出OID_SWITCH_PORT_PROPERTY_ENUM OID。 有关更多详细信息 ,请参阅查询 Hyper-V 可扩展交换机配置 。
注意 如果扩展收到 OID_SWITCH_PORT_PROPERTY_ENUM 的 OID 方法请求,则它不得完成 OID 请求。 相反,它必须调用 NdisFOidRequest ,以将 OID 请求向下转发到可扩展交换机驱动程序堆栈。
返回状态代码
可扩展开关的基础微型端口边缘完成 OID_SWITCH_PORT_PROPERTY_ENUM 的 OID 查询请求,并返回以下状态代码。
状态代码 | 说明 |
---|---|
NDIS_STATUS_SUCCESS |
OID 请求已成功完成。 |
要求
版本 |
在 NDIS 6.30 及更高版本中受支持。 |
标头 |
Ntddndis.h (包括 Ndis.h) |
另请参阅
NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO