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)