Hyper-V 可扩展交换机扩展发出OID_SWITCH_PROPERTY_ENUM获取数组的对象标识符(OID)方法请求。 此数组包含与指定条件匹配的预配交换机策略。 数组中的每个元素指定可扩展交换机策略的属性。
InformationBufferNDIS_OID_REQUEST 结构的成员包含指向缓冲区的指针。 此缓冲区包含以下数据:
一个 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 结构,指定可扩展交换机策略枚举的参数。
NDIS_SWITCH_PROPERTY_ENUM_INFO 结构的数组。 其中每个结构都包含有关可扩展交换机策略的信息。
注意 如果未使用指定可扩展交换机策略的实例预配扩展,则扩展会将 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 结构 成员的 NumProperties 设置为零,并且不会返回任何 NDIS_SWITCH_PROPERTY_ENUM_INFO 结构。
言论
仅当 Hyper-V 可扩展交换机已完成激活时,才能发出OID_SWITCH_PROPERTY_ENUM OID。 有关详细信息,请参阅 查询 Hyper-V 可扩展交换机配置。
与 OID_SWITCH_PORT_PROPERTY_ENUM的 OID 查询请求不同,扩展无需调用任何 ReferenceSwitchXxx 或 DereferenceSwitchXxx 函数,当扩展发出OID_SWITCH_PROPERTY_ENUM请求时,它会向下发出可扩展交换机驱动程序堆栈的请求。
注意 如果扩展收到 OID_SWITCH_PROPERTY_ENUM 的 OID 方法请求,则它不能完成 OID 请求。 相反,它必须调用 NdisFOidRequest,以便将 OID 请求转发到可扩展交换机驱动程序堆栈。
返回状态代码
可扩展交换机的基础微型端口边缘完成OID_SWITCH_PROPERTY_ENUM的 OID 查询请求,并返回以下状态代码之一。
状态代码 | 描述 |
---|---|
NDIS_STATUS_SUCCESS |
OID 请求已成功完成。 |
NDIS_STATUS_INVALID_LENGTH |
信息缓冲区的长度太小,无法返回 NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 结构及其 NDIS_SWITCH_PROPERTY_ENUM_INFO 元素数组。 可扩展交换机的基础微型端口边缘设置 数据。METHOD_INFORMATION。NDIS_OID_REQUEST 结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。 |
NDIS_STATUS_FAILURE |
由于其他原因,请求失败。 |
要求
版本 |
NDIS 6.30 及更高版本中受支持。 |
页眉 |
Ntddndis.h (包括 Ndis.h) |
另请参阅
NDIS_SWITCH_PROPERTY_ENUM_INFO