OID_SWITCH_PORT_PROPERTY_ENUM

Hyper-V 可扩展交换机扩展发出OID_SWITCH_PORT_PROPERTY_ENUM获取数组的对象标识符（OID）方法请求。 此数组包含与指定条件匹配的预配端口策略。 数组中的每个元素指定可扩展交换机端口的策略的属性。

InformationBufferNDIS_OID_REQUEST 结构的成员包含指向缓冲区的指针。 此缓冲区包含以下数据：

• 一个 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请求。

• 该扩展必须先调用 referenceSwitchPort，然后才能调用 NdisFOidRequest 发出OID_SWITCH_PORT_PROPERTY_ENUM请求。 这可确保在 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 查询请求，并返回以下状态代码。

要求

另请参阅

DereferenceSwitchPort

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS

NdisFOidRequest

查询 Hyper-V 可扩展交换机配置

ReferenceSwitchPort