OID_SWITCH_PROPERTY_ENUM

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

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

一个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 查询请求不同，扩展在向可扩展交换机驱动程序堆栈发出OID_SWITCH_PROPERTY_ENUM请求时，无需调用任何 ReferenceSwitchXxx 或 DereferenceSwitchXxx 函数。

注意如果扩展收到 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 元素数组。可扩展交换机的基础微型端口边缘设置 DATA。METHOD_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。
NDIS_STATUS_FAILURE	由于其他原因，请求失败。

版本	在 NDIS 6.30 及更高版本中受支持。
标头	Ntddndis.h (包括 Ndis.h)