NDIS_SWITCH_PARAMETERS 结构 (ntddndis.h)

项目
08/07/2023

NDIS_SWITCH_PARAMETERS 结构包含 Hyper-V 可扩展交换机的配置数据。

语法

typedef struct _NDIS_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_SWITCH_NAME         SwitchName;
  NDIS_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  UINT32                   NumSwitchPorts;
  BOOLEAN                  IsActive;
} NDIS_SWITCH_PARAMETERS, *PNDIS_SWITCH_PARAMETERS;

成员

Header

NDIS_SWITCH_PARAMETERS 结构的类型、修订和大小。此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

标头的 Type 成员必须设置为 NDIS_OBJECT_TYPE_DEFAULT。若要指定NDIS_SWITCH_PARAMETERS结构的版本，必须将 Header 的 Revision 成员设置为以下值：

NDIS_SWITCH_PARAMETERS_REVISION_1

NDIS 6.30 及更高版本的原始版本。

将 Size 成员设置为 NDIS_SIZEOF_NDIS_SWITCH_PARAMETERS_REVISION_1。

Flags

包含标志的按位 OR 的 ULONG 值。此成员是为 NDIS 保留的。

SwitchName

一个NDIS_SWITCH_NAME值，该值指定可扩展交换机的唯一内部名称。

内部交换机名称由基于 WMI 的策略管理应用程序使用。有关详细信息，请参阅管理 Hyper-V 可扩展交换机策略。

SwitchFriendlyName

一个 NDIS_SWITCH_FRIENDLYNAME 值，该值指定可扩展开关的用户友好说明。

NumSwitchPorts

一个 UINT32 值，该值指定在可扩展交换机上配置的端口数。

IsActive

一个 BOOLEAN，如果为 TRUE，则表示 Hyper-V 可扩展交换机激活已完成，并且可以安全地查询其他交换机配置，例如枚举端口、NIC 和属性。如果为 FALSE，则扩展必须等待 NetEventSwitchActivate PNP 事件发出，然后才能查询交换机配置。

注解

NDIS_SWITCH_PARAMETERS 结构在 OID_SWITCH_PARAMETERS 的 OID 请求中使用。

此结构还会在 Windows 筛选平台标注驱动程序的以下标注函数的 vSwitch 参数中传递：

注意NDIS_SWITCH_NAME和NDIS_SWITCH_FRIENDLYNAME数据类型由 IF_COUNTED_STRING 结构定义。此结构定义的字符串不必以 null 结尾。但是，字符串的长度必须在此结构的 Length 成员中设置。如果字符串以 null 结尾，则 Length 成员不得包含终止 null 字符。